RELEASE NOTES
Patch 20: Planned date: 23-07-2026
Availability
Recommended price for additional products - The RecomPrice field has been added to the AdditionalProducts response, making the recommended retail price directly available for display to the traveller. RecomPrice is preferred above the textual price PriceNotes.
Recap
Airport names in travel overview - Transport locations (airport names) are now included in the TravelMessage travel overview, so full departure and arrival airport details are visible.
Supply processing
ArrivalDate processing - The arrival date ArrivalDateon the accommodation is now processed and passed through from supply data.
Patch 19: Date: 22-04-2026
Updated Infant Age Calculation Logic
We have updated the criteria used to determine if a passenger qualifies for an infant fare.
Old Logic: Age was calculated based on the departure date of the trip. New Logic: Age is now calculated based on the departure date of the return flight.
Why this change? This ensures full compliance with international airline regulations. If a child turns 2 during the trip, they require a dedicated seat for the return journey and must be booked as a 'child' for the duration of the booking.
Updated several security patches
Patch 18: Date: Our middleware is deployed. Waiting for deployment of the backend.
Added transfers to bookflow
The current bookflow does not support adding and/or upgrading transfers. When a booking is made, a transfer is
automatically added if applicable to the chosen trip. In the "AssignResponse" the transfer was automatically added as
an "Extra" to the booking.
In the future, this will be changed so that all trips have "No transfer" as default. If the customer wants a transfer/upgrade,
it must be added during the booking process. The transfer options will be in the "AvailabilityResponse".
The options will be:
- "OPT_OUT" (Geen transfer)
- "SHARED" (Standard/bus transfer)
- "PRIVATE" (Private transfer/taxi)
Because it is possible to have more destination airports for a trip, the transfers are added at "Transport" level.
Transfers will be available in the following API:
- Availability(Response)
- Recap(Response)
Transfers must be added in the following APIs:
- Receipt
- Sell
- Assign
- Book
In the Recap, transfers were already shown as "Extra". However, they now fall under the "TransportExtras".
On the technical details page, there is an example of adding a transfer to the booking. The "OPT_OUT" transfer has been chosen here. But of course, you can choose from the options provided in the "AvailabilityResponse".
During a transition period, the BusTransfer may be the default.
If no transfer is added to the booking, the default transfer will be automatically booked.
Patch 17: Date: 2025-12-10
Maximum of nine passengers
Due to limitations in TUI backend systems, a check has been added to restrict bookings to a maximum of 9 passengers per reservation. If more than 9 passengers are provided, message '1028' from the ANVR XML standard will be returned.
This affects the following APIs:
- Availability
- AddProAvailability
- Receipt
- Sell
RequiredSeats is implemented This affects the following API, AddProAvailability.
Patch 16: Date: 2025-10-02
We are introducing two new luggage codes for extra items: PBAG and HBAG.
- PBAG refers to a personal item such as a laptop bag, purse, or shoulder bag, intended to be placed under the seat.
- HBAG refers to a small trolley or cabin bag, intended to be stored in the overhead compartment.
If neither PBAG nor HBAG is explicitly used, the luggage code BG00 will be interpreted as HBAG by default.
Patch 15:
Date: 2025-04-03
- Changing Supply Full and Delta delivery date, first delta 30 min. later
Patch 14:
Date planned: 2025-04-15
- Added extra Cancellation information
In AddProvAvailability, Sell and RecapResponse extra information is given when there are different cancellation policies for a certain carrier. This is in the Class Group in Transport. (See examples).
Patch 13:
Date: 2024-11-13
- Added discounts (See examples under Technical Details)
In Receipt, Assign and BookRequest a discount code could be provided
In Receipt, Assign and RecapResponse a Price detail for discount will be shown
Patch 12:
Date: 2024-11-13
- Added Errata messages (See examples under Technical Details)
In Receipt, Assign and RecapResponse errata's are added
Patch 11:
Date: 2024-11-13
- Added boardtypes UA and LD
Patch 10:
Date: 2024-05-27
Techical details page
- Extra XML examples, added Local costs download
- Added local cost in the examples
Patch 9:
Date: 2024-04-10
- In Recap: added transfer to Extra group
- In Recap: fixed invoice number for cancelled bookings
- Fixed determine OperationalCarrier
- Fixed some translations
Patch 8:
Date: 2024-03-25
Changes for ACM local costs
Added new fields to UnitPrice group in xsd:
- PriceIncluded
- PriceLocalIncluded
These fields are conform v3.2.2 (of the anvr) but for now not mandatory
When implemented in backend, examples will be added
Patch 7:
Date: 2024-03-15
Added ExtrasCategoryType "stoelen" to xsd
AddProAvailability
- Added extrasCategoryType "stoelen" for seatupgrades
Recap
- Added extrasCategoryType "stoelen" for seatupgrades
- Also added GroupID in the examples
Overall
- Changed XML examples for seatupgrades
Patch 6:
Planned date: 2024-02-05
Extra XML examples
Added extra xml examples at technical-details page
- Fastbooking
- Standard booking
- Flightupgrades
- Deluxe class
Overal (api)
- Added CONTRACTED/DYNAMIC in TransportID as third element (# seperated).
This will not change G7XML functionality but is needed for backend api's. - Added G7 authorisation message (number 104) so in case of unknown ANVR code this message is given instead of general error "Error in backend system"
Availability
- Changed flightnumber from only number part to format "CCCNNNN" where CCC= (marketing) carriercode and NNNN=numberpart
- CarrierID field is the operating carrier
- Prices for Transport Class and priceNotes in cents
AddProAvailability
- Added seatupgrades to response,only support same seatupgrade for out- and returnflight
Sell, ASSIGN, BOOK, Receipt
- Use CarrierID and FlightNumber
- Use CONTRACTED/DYNAMIC from TransportID
- Luggage and seat upgrades must be the same for In- and Outflights (may change in future).
- Check for same upgrades in SellRequest can only be done if Extra/GroupID is included in XML
Otherwise validation is in AssignRequest, which results in extra not needed requests
Recap
- CONTRACTED/DYNAMIC in TransportID
- Operation Carrier, format flightnumber
- InvoiceID added
- Accommodation Name, address (maybe)
- Unit name
- Journey duration
- Fix: Phone number
- Fix Accommodation date format in pricedetails.
Patch 5:
Date: 2023-11-21
Availability
- Extras have the right PricePer, "PA" instead of "PN"
AddProAvailability
- Field ExtrasCategory is added
Assign
- Fix for eliminating the right area code of the phone number
Patch 4:
Date: 2023-09-28
Recap
- Fix for invalid contact data
- Add date and time to the extras
Receipt
- Fix for displaying discount
Book
- Add ResponseStatus to the BookResponse
Patch 3:
Date: 2023-09-06
It is not always clear what the default extras are that are added in the bookflow during AssignResponse. Extra information(description) is added in the Transport-AdditionalProducts and the AdditionalProducts.
API specification
- Added the transport and additionalProducts group to AssignResponse
- Examples are updated
Technical details page
- Examples are updated
Patch 2:
Date: 2023-05-22
XSD
- Added "MessageID" with value "0" to the enumeration list
This MessageID with value "O" will be used for custom TUI messages - Moved "GroupID" to the last item in "Extras"
- Moved "GroupID" to the last item in "TransportRental"
- Moved "RelatedTransport" to last item in "ExtrasAssignment"
These fields where not added as last items of a group, because TUI asked to add these fields in version 3.2 likely they will be added as last items of the group. So changing this already in version 3.1 (while it is not in production yet) will make the updated to version 3.2 in the future easier with lesser changes.
API specification
- See changes with XSD
- The examples are updated
Technical details page
- The examples are updated
Postman collection
- The examples in the Postman collection are updated with the mentioned changes
These updates will not affect backend processes
Patch 1:
Date: 2023-01-01
This Patch describes the changes between the ANVR G7 TravelMessage v3.1 and the customized TUI 3.1 version.
XSD
- BaseBoardType: Added 3 specific TUI boardtypes
- PH/ph: halfpension plus
- PV/pv: volpension plus
- PA/pa: all inclusive plus
- StatusValue: Added canceled status
- Geannuleerd/geannuleerd
- Class: Added PaxID (used for Receipt)
- Unit: Added RoomAssignment (used for Receipt)
- UnitPrice: Added Occupancy (price per occupancy)
- Extras: Added ExtrasPax(used for Receipt) and GroupID
- TransportRental: Added PaxID(used for Receipt) and GroupID
- ExtrasAssignment: Added RelatedTransport
- BookResponse.OptionDate: field is optional now
- Changed ReceiptRequest
- Transport reference to the Transport group
- Accommodation reference to the Accommodation group
- Added AdditionalProducts
- Changed ReceiptResponse
- Changed PriceInfo reference to PriceInfo group
- Removed PricePayLocally
API specification
- Examples added
Technical details page
- Examples added
Postman collection
- Postman collection with examples added
