Travelfusion Direct Connect XML API > Post Booking APIs > Manage Booking API
Change Option DETAILS example Manage Booking flow
ManageBookingAvailabilityPlane
REQUEST example
<CommandList>
<ManageBookingAvailabilityPlane>
<XmlLoginId>XMLLOGINID</XmlLoginId>
<LoginId>LOGINID</LoginId>
<Supplier>britishairways</Supplier>
</ManageBookingAvailabilityPlane>
</CommandList>
RESPONSE example
<CommandList>
<ManageBookingAvailabilityPlane>
<LoginId>LOGINID</LoginId>
<Supplier>britishairways</Supplier>
<ChangeOptions>OUT_DATE|RET_DATE|LUGGAGE|CANCEL|DETAILS</ChangeOptions>
<AuthOptionList>
...
</AuthOptionList>
<SupplierInfoList>
...
</SupplierInfoList>
<DetailList>
<Detail Name="TitleAndFirstName" PerPassenger="true"/>
<Detail Name="Email" PerPassenger="false"/>
<Detail Name="BookingMobilePhone" PerPassenger="false"/>
</DetailList>
</ManageBookingAvailabilityPlane></CommandList>
ProcessDetails
The ProcessDetails response example XML, below, shows some of the supported required parameters for details change. Please refer to the Custom Supplier Parameters Guide to understand how to handle these parameters. Additional parameters that are not included in that guide are listed here:
In some cases, airlines define a fixed amount for any details change per transaction. The FixedDetailsChangeCharge parameter specifies this fixed amount charged, and it applies for any details change specified in the rest of the parameters. If this parameter is present in the response, then the rest of the DETAILS related parameters will have zero price.
REQUEST example
<CommandList>
<ProcessDetails>
<XmlLoginId>XMLLOGINID</XmlLoginId>
<LoginId>LOGINID</LoginId>
<RoutingId>Z1RL63H6CNXONXL2</RoutingId>
<OutwardId>ELBHDRMXTDRX27OH</OutwardId>
<ReturnId>EWY74ZJWCF2VOQ9I</ReturnId>
</ProcessDetails>
</CommandList>
RESPONSE example
<CommandList>
<ProcessDetails>
<LoginId>LOGINID</LoginId>
<RoutingId>Z1RL63H6CNXONXL2</RoutingId>
<Router>
<RequiredParameterList>
...
<RequiredParameter>
<Name>Email</Name>
<Type>text</Type>
<DisplayText>Email address: 0.00 EUR</DisplayText>
<PerPassenger>false</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
<RequiredParameter>
<Name>BookingMobilePhone</Name>
<Type>text</Type>
<DisplayText>Mobile phone: 0.00 EUR</DisplayText>
<PerPassenger>false</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
...
</RequiredParameterList>
...
</Router>
...
<ManagedTravellerList>
<ManagedTraveller>
<Name>
<Title>Mr</Title>
<NamePartList>
<NamePart>JONNNY JOSE</NamePart>
<NamePart>WILLSON</NamePart>
</NamePartList>
</Name>
<TravellerType>Adult</TravellerType>
<Age>31</Age>
<SupplierTravellerInfoList>
<SupplierTravellerInfo>
<DisplayName>Birthdate</DisplayName>
<InfoType>text</InfoType>
<Info>1989-02-03</Info>
</SupplierTravellerInfo>
<SupplierTravellerInfo>
<DisplayName>Gender</DisplayName>
<InfoType>text</InfoType>
<Info>Male</Info>
</SupplierTravellerInfo>
</SupplierTravellerInfoList>
<RequiredParameterList>
<RequiredParameter>
<Name>FirstNameAndLastName</Name>
<Type>text</Type>
<DisplayText>First name and last name: 1-letters (0.00 EUR), 2-letters (0.00 EUR), 3-letters (0.00 EUR)</DisplayText>
<PerPassenger>true</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
<RequiredParameter>
<Name>Title</Name>
<Type>value_select</Type>
<DisplayText>Please select title: 1 (DR - 12.00 EUR), 2 (MR - 15.00 EUR)</DisplayText>
<PerPassenger>true</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
<RequiredParameter>
<Name>OutwardLuggageOptions</Name>
<Type>value_select</Type>
<DisplayText>Please Select Outward Luggage Option: 1 (1 bags - 23Kg total - 40.00 EUR), 2 (2 bags - 46Kg total - 110.00 EUR), 3 (3 bags - 69Kg total - 180.00 EUR), 4 (4 bags - 92Kg total - 250.00 EUR), 5 (5 bags - 115Kg total - 320.00 EUR), 6 (6 bags - 138Kg total - 390.00 EUR), 7 (7 bags - 161Kg total - 460.00 EUR), 8 (8 bags - 184Kg total - 530.00 EUR), 9 (9 bags - 207Kg total - 600.00 EUR), 10 (10 bags - 230Kg total - 670.00 EUR)</DisplayText>
<PerPassenger>true</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
<RequiredParameter>
<Name>ReturnLuggageOptions</Name>
<Type>value_select</Type>
<DisplayText>Please Select Return Luggage Option: 1 (1 bags - 23Kg total - 40.00 EUR), 2 (2 bags - 46Kg total - 110.00 EUR), 3 (3 bags - 69Kg total - 180.00 EUR), 4 (4 bags - 92Kg total - 250.00 EUR), 5 (5 bags - 115Kg total - 320.00 EUR), 6 (6 bags - 138Kg total - 390.00 EUR), 7 (7 bags - 161Kg total - 460.00 EUR), 8 (8 bags - 184Kg total - 530.00 EUR), 9 (9 bags - 207Kg total - 600.00 EUR), 10 (10 bags - 230Kg total - 670.00 EUR)</DisplayText>
<PerPassenger>true</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
</RequiredParameterList>
</ManagedTraveller>
</ManagedTravellerList>
...
</ProcessDetails>
</CommandList>
ProcessTerms
The users submit the desired new details values in the ProcessTerms request. Name related parameters that combine more than one title and name parts must use comma(s) in their values to separate those parts. For example, for traveller
<Name>
<Title>Mr</Title>
<NamePartList>
<NamePart>JOHNNY JOSE</NamePart>
<NamePart>WILLSON</NamePart>
</NamePartList>
</Name>
all possible name change parameters would have to be submitted as follows.
<CustomSupplierParameter>
<Name>FullName</Name>
<Value>Mr,JOHN JOSE,WILLSON</Value>
</CustomSupplierParameter>
<CustomSupplierParameter>
<Name>FirstNameAndLastName</Name>
<Value>JOHN JOSE,WILLSON</Value>
</CustomSupplierParameter>
<CustomSupplierParameter>
<Name>FirstName</Name>
<Value>JOHN JOSE</Value>
</CustomSupplierParameter>
<CustomSupplierParameter>
<Name>TitleAndFirstName</Name>
<Value>Mr,JOHNNY JOSH</Value>
</CustomSupplierParameter>
<CustomSupplierParameter>
<Name>LastName</Name>
<Value>WILL</Value>
</CustomSupplierParameter>
The ProcessTerms response will contain a tax item named "Details Change Charge" if the details changes are applicable.
REQUEST example
<CommandList>
<ProcessTerms>
<XmlLoginId>XMLLOGINID</XmlLoginId>
<LoginId>LOGINID</LoginId>
<Mode>plane</Mode>
<RoutingId>Z1RL63H6CNXONXL2</RoutingId>
<BookingProfile>
<TravellerList>
<Traveller>
<Name>
<Title>Mr</Title>
<NamePartList>
<NamePart>JOHNNY JOSE</NamePart> <!-- current name -->
<NamePart>WILLSON</NamePart>
</NamePartList>
</Name>
<CustomSupplierParameterList>
<CustomSupplierParameter>
<Name>DateOfBirth</Name>
<Value>03/02/1989</Value>
</CustomSupplierParameter>
<CustomSupplierParameter>
<Name>FirstNameAndLastName</Name>
<Value>JOHN JOSE,WILLSON</Value> <!-- changed name, name parts comma separated -->
</CustomSupplierParameter>
</CustomSupplierParameterList>
</Traveller>
<Traveller>
<Name>
<Title>Mr</Title>
<NamePartList>
<NamePart>MOISES</NamePart>
<NamePart>WILLSON</NamePart>
</NamePartList>
</Name>
<CustomSupplierParameterList>
<CustomSupplierParameter>
<Name>DateOfBirth</Name>
<Value>03/02/2010</Value>
</CustomSupplierParameter>
</CustomSupplierParameterList>
</Traveller>
</TravellerList>
...
</BookingProfile>
</ProcessTerms>
</CommandList>
RESPONSE example
<CommandList>
<ProcessTerms millis="170">
<LoginId>LOGINID</LoginId>
<RoutingId>Z1RL63H6CNXONXL2</RoutingId>
<TFBookingReference>BOOKINGREFERENCE</TFBookingReference>
<Router>
...
<GroupList>
<Group>
...
<Price>
<Amount>10.00</Amount>
<Currency>EUR</Currency>
<TaxItemList>
<TaxItem>
<Name>Details change charge</Name>
<Amount>10.00</Amount>
<Currency>EUR</Currency>
</TaxItem>
</TaxItemList>
</Price>
</Group>
</GroupList>
<SupplierInfoList>
...
</SupplierInfoList>
</Router>
</ProcessTerms>
...
</CommandList>