Accommodation

Overview

Accommodation Services extend the CommonService to carry accommodation specific information. The main element holds basic service information to give a brief overview about the main characteristics which are fully inherited by the CommonService Element. Accommodation specific information are held using a List of room elements and a List of transfer elements.

Available attributes slightly differ for the given direction of the message (Request/Response).

Request element

<Accommodation>
    <!-- CommonService elements -->
    ...
    <!-- Accommodation specific elements -->
    <Rooms>
        <Room>
            <Identifier>01</Identifier>
            <AssignedTraveller>
                <Identifier>01</Identifier>
                <Identifier>02</Identifier>
            </AssignedTraveller>
            <RoomCode>
                <Code>DS</Code>
            </RoomCode>
            <Board>
                <Code>BF</Code>
            </Board>
            <CustomerRequests>
                <Description>
                    <Text>Superior Doppelzimmer mit Frühstück</Text>
                </Description>
            </CustomerRequests>
        </Room>
    </Rooms>
</Accommodation>

Full File

In case of a Request the structure is also capable of holding service related customerRequests for a desired CheckIn/Out time.

Response Element

The Response on the other hand is meant to represent the view of the TourOperator on the request. In case of CheckIn/out Times the values are either reflected in meaning of confirmation or correction. The Response also carries more specific information about the requested accommodation service like LocationDetails or a Stay element to inform about charged nights and CheckIn/Out Times.

<Accommodation>
     <!-- CommonService elements -->
     ...
     <!-- Accommodation specific elements -->
    <LocationDetails>
        <GeoLocation>
            <Longitude>2.314477</Longitude>
            <Latitude>48.87173</Latitude>
        </GeoLocation>
        <Contact>
            <Mail>reservations.lebristolparis@oetkercollection.com</Mail>
            <Phone>+33 153 43 43 00</Phone>
            <URL>http://www.lebristolparis.com/eng/home</URL>
        </Contact>
        <Address>
            <AddressLines>
                <AddressLine>Le Bristol Paris</AddressLine>
            </AddressLines>
            <Street>Rue du Faubourg Saint Honoré</Street>
            <Additional>08. Arrondissement - Champs Élysées</Additional>
            <HouseNumber>112</HouseNumber>
            <ZIPCode>75008</ZIPCode>
            <City>Paris</City>
            <Country>
                <Name>Frankreich</Name>
                <CountryCode>FR</CountryCode>
            </Country>
        </Address>
        <Regions>
            <Region>
                <Code>FR-IDF</Code>
                <Description>
                    <Text>Ille de France</Text>
                </Description>
            </Region>
        </Regions>
    </LocationDetails>
    <Rooms>
        <Room>
            <Identifier>01</Identifier>
            <AssignedTraveller>
                <Identifier>01</Identifier>
                <Identifier>02</Identifier>
            </AssignedTraveller>
            <RoomCode>
                <Code>DS</Code>
                <Description>
                    <Text>Doppelzimmer Superior</Text>
                </Description>
                <Description>
                    <Text>Zimmer größer als der Durchschnitt in Paris: 40 m², mit großem Doppelbett</Text>
                </Description>
            </RoomCode>
            <Board>
                <Code>BF</Code>
            </Board>
            <State>OK</State>
        </Room>
    </Rooms>
    <Stay>
        <ChargedNights>7</ChargedNights>
        <CheckInOut/>
    </Stay>
</Accommodation>

Full File

Room Element

A Room-Element, as the name suggests, represents a physical room in the accommodation facility. Each room has an (optional) List of assigned travellers, which can be used to directly assign the travellers to a specific room.

It is represented by a RoomCode Element holding code and description of the room category. Specific attributes of the room (like room facilities). In addition to that, it holds the selected board and a List of included extra services, all represented by a code and a description. Whereas the code in these elements is intended to be used mainly in a technical manner and the description to be used for presentation, the description is an optional element. If not set, the code has to be used to describe room, board or included extras.

<Room>
	<Identifier>01</Identifier>
	<AssignedTraveller>
		<Identifier>01</Identifier>
		<Identifier>02</Identifier>
	</AssignedTraveller>
	<RoomCode>
		<Code>DS</Code>
		<Attributes>
			<Attribute>
				<Code>SAFE</Code>
				<Description>Safe</Description>
				<AttributeSource>Touroperator</AttributeSource>
			</Attribute>
			<Attribute>
				<Code>DESK</Code>
				<Description>Schreibtisch</Description>
				<AttributeSource>Touroperator</AttributeSource>
			</Attribute>
		</Attributes>
		<Description>
			<Text>Doppelzimmer Superior</Text>
		</Description>
		<Description>
			<Text>Zimmer größer als der Durchschnitt in Paris: 40 m², mit großem Doppelbett</Text>
		</Description>
	</RoomCode>
	<Board>
		<Code>BF</Code>
		<Description>
			<Text>Frühstück</Text>
		</Description>
	</Board>
	<IncludedExtras>
		<IncludedExtra>
			<ExtraCode>
				<Code>WIFI</Code>
				<Description>Kostenfreies WLAN auf allen Zimmern</Description>
			</ExtraCode>
		</IncludedExtra>
	</IncludedExtras>
	<State>OK</State>
</Room>

Available Room-Element attributes

Attribute	Values / Explanation
@Identifier	This is a unique identifier within one message, which can be used to reference on a concrete room
AssignedTraveller	A list of traveller Ids, representing the traveller assigned to this specific room
RoomCode	The room category code identifying this specific class of room. Can be enriched by textual desriptions of the room.
RoomCode/Attributes	A list of special attributes of the room structured in a @Code, a @Description (for display purposes) and the @AttributeSource indicating the source/type of that attribute code
Board/Code	The code representing the assigned mealplan for that room
Board/Description	A descriptive text for the mealplan (for display purposes)
CustomerRequests (Request only)	A List of texts holding customer specific request information
IncludedExtras	A List of extras included for that room category