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:

 Name Type
 FullName text
 FirstNameAndLastName text
 FirstName text
 TitleAndFirstName text
 LastName text
 Title value_select
 DateOfBirth see CSP guide
 Nationality see CSP guide
 Email text
 HomePhone text
 BookingMobilePhone text
 WorkPhone text
 PassportNumber see CSP guide
 PassportExpiryDate see CSP guide
 PassportCountryOfIssue see CSP guide
 FixedDetailsChangeCharge notice

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>
          <Age>31</Age>
          <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>
          <Age10</Age>
          <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>
Comments