Accommodation: Unterschied zwischen den Versionen

Aus DRV STRING
Wechseln zu: Navigation, Suche
(Available Room-Element attributes)
(Available Room-Element attributes)
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 167: Zeile 167:
 
| '''@Identifier'''|| This is a unique identifier within one message, which can be used to reference on a concrete room
 
| '''@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
+
| '''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'''|| 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 <br>a @Code, <br>a @Description (for display purposes) and <br>the @AttributeSource indicating the source/type of that attribute code
+
| '''RoomCode/Attributes'''|| A list of special attributes of the room structured in <br>a @Code, <br>a @Description (for display purposes) and <br>the @AttributeSource indicating the source/type of that attribute code
 
|-
 
|-
| '''@Board/Code'''|| The code representing the assigned mealplan for that room
+
| '''Board/Code'''|| The code representing the assigned mealplan for that room
 
|-
 
|-
| '''@Board/Description'''|| A descriptive text for the mealplan (for display purposes)
+
| '''Board/Description'''|| A descriptive text for the mealplan (for display purposes)
 
|-
 
|-
| '''@CustomerRequests''' (Request only)|| A List of texts holding customer specific request information
+
| '''CustomerRequests''' (Request only)|| A List of texts holding customer specific request information
| '''@IncludedExtras'''|| A List of extras included for that room category
+
|-
 +
| '''IncludedExtras'''|| A List of extras included for that room category
 
|}
 
|}

Aktuelle Version vom 27. Juni 2018, 12:45 Uhr

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