Schnittstellen_AICP

Datenschnittstellen
Stand: 19.08.2008
1 Hotelverfügbarkeit
Die Dateien mit den verfügbaren Unterbringungen werden unter folgendem Namen ausgeliefert:
Marke-HOTEL-VERF.zip

Spalte		Feld	Format	Beispiel
Von	Bis
Schlüsselfelder
001	004	Marke	A4	NEC
005	008	Katalogkürzel	A4	NAH
009	012	Katalogsaison	A4	S06
013	015	Reiseziel	A3	PMI
016	020	Angebotscode	A5	11250
021	021	Unterbringungstyp	A1	A
022	022	Zimmerart	A1	2
023	023	Zimmertyp	A1	A
024	033	Angebotstermin	A10	01.08.2006
Attribute
034	083	Verfügbare Dauern 1 bis 50. Die Position des Verfügbarkeits-Kz bezeichnet die Dauer. Ausprägungen: V = verfügbar N = nicht verfügbar R = auf Request	A50	NNNNVNV…
084	086	Maximal verfügbare Dauer	N3	028
087	088	Mindestbelegung	N2	02
089	090	Maximale Belegung (ohne Zustellbetten)	N2	02
091	091	Anzahl zulässige Zustellbetten	N1	1
092	092	Mindestanzahl zu belegender Zustellbetten	N1	0
093	094	Maximales Alter für Zustellbetten	N2	12
095	102	Verpflegungen. Maximal 4 sprachabhängige Vpfl-Codes. Die deutschen Werte sind: OV = ohne Verpflegung FR = Frühstück HP = Halbpension VP = Vollpension AI = All inclusive LP = laut Prospekt	A8	OVFRHPVP
103	104	Zimmerklassifikation. Die Codes können über die Umsetzungstabelle CODES-KLASSIF-spra sprachabhängig in Langtexte übersetzt werden.	A2	H2
105	122	Zimmerausstattungsmerkmale. Maximal 9 zweistellige Codes, die über die Umsetzungstabelle CODES-AUSSTATT-spra sprachabhängig in Langtexte übersetzt werden können.	A18	BDWCBK
123	123	Dummy-Unterbringung (J/N). Das Kennzeichen besagt, dass es sich um eine Dummy-Unterbringung handelt, die bei NurFlügen dazugebucht werden muss.	A1	N
124	124	Eigene Anreise möglich (J/N). Das Kennzeichen besagt, dass auf die Saison bezogen eigene Anreise angeboten wird. Ob zum konkreten Termin eigene Anreise erlaubt ist, muss aus den Angebotsdaten bzw. eine Verfügbarkeitsanfrage ermittelt werden.	A1	N
125	125	Zwangsinfo-Kz. Angabe (J/N), ob es zu der Unterbringung eine Zwangsinfo gibt.	A1	J
126	126	Preisänderungs-Kz. Angabe (J/N), ob sich der Unterbringungspreis über Nacht geändert hat.	A1	N
127	129	Zulässige Mindestdauer. Ob sie tatsächlich verfügbar ist, ist aus der Liste der verfügbaren Dauern ersichtlich.	N3	003
130	130	Verkaufskanal. Angabe, ob ein Angebot uneingeschränkt verkauft werden kann oder nur über bestimmte Verkaufskanäle. Leer = alle Verkaufskanäle R = nur Reisebüros	A1
131	150	Filler für zukünftige Erweiterungen.	A20

Satzlänge = 150 Byte.
Hinweis zu den Dauern
Die Dauern werden maximal bis 50 separat ausgewiesen. Wird eine Dauer > 50 angefragt, dann kann anhand des Feldes Maximal verfügbare Dauer erkannt werden, ob dies grundsätzlich möglich ist. Ob eine Dauer, die zwischen 50 und der maximal verfügbaren Dauer liegt, tatsächlich verfügbar ist, muss durch eine Online-Verfügbarkeitsanfrage geprüft werden.
2Hotelzusatzinformationen
Die Dateien mit den Hotelzusatzinformationen werden unter folgenden Namen ausgeliefert:
Marke-HOTEL-ZUSATZ.zip

Spalte		Feld	Format	Beispiel
Von	Bis
Schlüsselfelder
001	004	Marke	A4	NEC
005	008	Katalogkürzel	A4	NAH
009	012	Katalogsaison	A4	S06
013	015	Reiseziel	A3	PMI
016	020	Angebotscode	A5	11250
021	021	Unterbringungstyp	A1	A
Attribute
022	061	Ortsname	A40	Cala Ratjada
062	101	Hotelname	A40	Hotel Bella Playa
102	104	Hotelkategorie	N,N	4,5
105	106	Unterkunftsart. Die Codes können über die Umsetzungstabelle CODES-UNTERKUNFT-spra sprachabhängig in Langtexte übersetzt werden.	A2	H
107	109	Seitennummer des Hotels im Farbteil des gedruckten Katalogs.	N3	039
110	112	Seitennummer des Hotels im Preisteil des gedruckten Katalogs.	N3	064
113	192	20 vierstellige Hotelmerkmale, von den jeweiligen Produktmanagern definiert. Die Codes können über die Umsetzungstabelle CODES-MERKMALE-spra sprachabhängig in Langtexte übersetzt werden.	A80	A8WEB2RAEXKL
193	196	4-stelliger interner Ortscode	A4	1105
197	500	Filler für zukünftige Erweiterungen.	A304

Hinweise

Es werden grundsätzlich nur Zusatzinformationen zu solchen Hotels geliefert, die auch in den Hotelverfügbarkeiten enthalten sind.
Die Hotelmerkmale werden zurzeit nur für die sog. TOC-Urlaubsplaner verwendet.

3 Beförderungsverfügbarkeit
Die Dateien mit den verfügbaren Beförderungen werden unter folgendem Namen ausgeliefert:
Marke-BEFO-VERF.zip

Spalte		Feld	Format	Beispiel
Von	Bis
Schlüsselfelder
001	004	Marke	A4	NEC
005	008	Katalogkürzel	A4	NAH
009	012	Katalogsaison	A4	S06
013	015	Reiseziel. Es kann abweichen vom Zielflughafen.	A3	PMI
016	016	Beförderungstyp.	A1	F
017	019	Abflughafen (Internationaler Dreiletter-Code).	A3	FRA
020	022	Zielflughafen (Internationaler Dreiletter-Code).	A3	PMI
023	023	Beförderungsnummer	A1	1
024	024	Beförderungsklasse	A1	2
025	034	Angebotstermin	A10	01.08.2006
Attribute
035	084	Verfügbare Dauern 1 bis 50. Die Position des Verfügbarkeits-Kz bezeichnet die Dauer. Ausprägungen: N = nicht verfügbar V = verfügbar (Anzahl Plätze nicht ermittelt) 1 = verfügbar, Anzahl freie Plätze = 1 2 = verfügbar, Anzahl freie Plätze = 2(kumuliert über alle Verbindungen) … 9 = verfügbar, Anzahl freie Plätze >= 9(kumuliert über alle Verbindungen)	A50	NNNNVNV…
085	087	Maximal verfügbare Dauer.	N3	028
088	088	NurFlug möglich (J/N). Das Kennzeichen besagt, dass auf die Saison bezogen NurFlüge angeboten werden. Ob es zum konkreten Termin NurFlüge gibt, muss aus den Angebotsdaten bzw. eine Verfügbarkeitsanfrage ermittelt werden.	A1	N
089	093	Angebotscode für NurFlug (Dummyhotel)	A5
094	094	Unterbringungstyp für NurFlug	A1
095	097	Via-Flughafen. Die Information besagt lediglich, dass es auf einzelnen Verbindungen Via-Flüge geben kann. Es heißt nicht, dass es sich immer um Via-Flüge handelt.	A3
098	098	Externer Fluganteil (J/N). Die Information besagt lediglich, dass es auf einzelnen Verbindungen externe Linienflüge geben kann. Es heißt nicht, dass es sich immer um externe Flüge handelt.	A1	N
099	099	Zwangsinfo-Kz. Angabe (J/N), ob es zum Flug eine Zwangsinfo gibt. Die Zwangsinfo bezieht sich nur auf den Abreisetermin, nicht auf den Rückreisetermin.	A1	J
100	100	Preisänderungs-Kz. Angabe (J/N), ob sich der Flugpreis über Nacht geändert hat.	A1	N
101	110	Hotelantrittsdatum. Es kann bei Übernachtflügen vom Flugdatum abweichen.	A10	01.08.2006
111	150	Filler für zukünftige Erweiterungen.	A40

Satzlänge = 150 Byte.
Hinweis zu den Dauern
Die Dauern werden maximal bis 50 separat ausgewiesen. Wird eine Dauer > 50 angefragt, dann kann anhand des Feldes Maximal verfügbare Dauer erkannt werden, ob dies grundsätzlich möglich ist. Ob eine Dauer, die zwischen 50 und der maximal verfügbaren Dauer liegt, tatsächlich verfügbar ist, muss durch eine Online-Verfügbarkeitsanfrage geprüft werden.
Hinweise zur Verfügbarkeit

Wenn eine Beförderung als nicht verfügbar gekennzeichnet ist, dann sind Online-Anfragen in jedem Fall überflüssig.
Bei der Erstellung der Verfügbarkeitsdatei werden aus Perfomancegründen keine Amadeus-Anfragen gemacht. Bei Beförderungen mit externem Fluganteil wird die Annahme getroffen, dass der externe Flug verfügbar ist. Endgültige Gewissheit kann erst die Buchungsanfrage liefern.
Beförderungen, die in der Datei als verfügbar gekennzeichnet sind, können selbstverständlich im Laufe des Tages ausgebucht werden. Da i.d.R. weniger Flugplätze als Zimmer zur Verfügung stehen, ist dieses Risiko bei Beförderungen größer als bei den Unterbringungen.
Beförderungen, die auf Request stehen, werden zurzeit nicht ausgeliefert.

4Update Beförderungsverfügbarkeit tagsüber
Die stündlich aktualisierte Datei mit den Verfügbarkeitsänderungen (insbesondere ausgebuchte Beförderungsstrecken) wird unter folgendem Namen bereitgestellt:
Marke-BEFO-VERF-UPD.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	019	Timestamp in der Form JJJJ-MM-TT-HH.MM.SS. Er ist derselbe für alle Sätze, die innerhalb eines Updatezyklus erzeugt werden.	A19	2006-11-01-12.10.15
020	023	Marke	A4	NEC
024	027	Katalogkürzel	A4	NAH
028	031	Katalogsaison	A4	W07
032	034	Reiseziel	A3	PMI
035	035	Beförderungstyp	A1	F
036	038	Abflughafen (internationaler Dreiletter-Code)	A3	FRA
039	041	Zielflughafen (internationaler Dreiletter-Code)	A3	PMI
042	042	Beförderungsnummer	A1	1
043	043	Beförderungsklasse	A1	2
044	053	Angebotstermin	A10	01.12.2006
054	103	Verfügbare Dauern von 1 bis 50. Die Position des Verfügbarkeits-Kz bezeichnet die Dauer. Ausprägungen: V = verfügbar N = nicht verfügbar R = auf Request ? = nicht geprüft	A50	??V?N?N…
104	150	Filler für zukünftige Erweiterungen	A47

5Angebotsdaten
Die Dateien mit den konkreten Angeboten und Preisen werden unter folgenden Namen ausgeliefert:

Marke-ANGEBOTE-FLUG-Dn.zipNurFlug-Angebote (TIP-Flüge)
Marke-ANGEBOTE-HOTEL-Dn.zipAngebote mit eigener Anreise (TIP-Hotels)
Marke-ANGEBOTE-PAUSCHAL-Dn.zipPauschalangebote

Spalte		Feld	Format	Beispiel
Von	Bis
Schlüsselfelder
001	004	Marke	A4	NEC
005	008	Katalogkürzel	A4	NAH
009	012	Katalogsaison	A4	S06
013	015	Reiseziel	A3	PMI
016	020	Angebotscode	A5	11250
021	021	Unterbringungstyp	A1	A
022	022	Beförderungstyp. Ausprägungen: A = eigene Anreise B = Bus F = Flug Z = Zug	A1	F
023	025	Abflughafen-Hin (bei eigener Anreise leer)	A3	FRA
026	028	Zielflughafen-Hin (bei eigener Anreise leer)	A3	PMI
029	031	Abflughafen-Rück (bei eigener Anreise leer)	A3	PMI
032	034	Zielflughafen-Rück (bei eigener Anreise leer)	A3	FRA
035	037	Maschinenkennung Hin	A3	DE
038	040	Maschinenkennung Rück	A3	YP
041	050	Angebotstermin	A10	01.08.2006
051	053	Angebotsdauer	N3	014
054	054	Zimmerart	A1	2
055	055	Zimmertyp	A1	A
056	056	Anzahl verfügbare Zustellbetten	N1	1
057	058	Verpflegung. Es handelt sich um den sprachabhängigen Vpfl-Code. Die deutschen Werte sind: OV = ohne Verpflegung FR = Frühstück HP = Halbpension VP = Vollpension AI = All inclusive LP = laut Prospekt	A2	OV
Attribute
059	061	Währung	A3	EUR
062	071	Vollzahlerpreis	N10	0000000798
072	072	Preistyp (P=personenbezogen, O=objektbezogen)	A1	P
073	082	Kinderpreisfestpreis (1)	N10	0000000299
083	086	Proz. Ermäßigung (1), alternativ zu Kinderfestpreis (1)	A4	-000
087	088	Kinderalter von (1)	N2	02
089	090	Kinderalter bis (1)	N2	06
091	092	Maximale Anzahl der ermäßigten Personen (1)	N2	01
093	094	Anzahl der erforderlichen Vollzahler (1)	N2	02
095	095	Zustellbettenpflicht (J/N) (1)	A1	J
096	105	Kinderpreisfestpreis (2)	N10	0000000000
106	109	Proz. Ermäßigung (2), alternativ zu Kinderfestpreis (2)	A4	-020
110	111	Kinderalter von (2)	N2	07
112	113	Kinderalter bis (2)	N2	11
114	115	Maximale Anzahl der ermäßigten Personen (2)	N2	01
116	117	Anzahl der erforderlichen Vollzahler (2)	N2	02
118	118	Zustellbettenpflicht (J/N) (2)	A1	J
119	128	Kinderpreisfestpreis (3)	N10	0000000000
129	132	Proz. Ermäßigung (3), alternativ zu Kinderfestpreis (3)	A4	-000
133	134	Kinderalter von (3)	N2	00
135	136	Kinderalter bis (3)	N2	00
137	138	Maximale Anzahl der ermäßigten Personen (3)	N2	01
139	140	Anzahl der erforderlichen Vollzahler (3)	N2	02
141	141	Zustellbettenpflicht (J/N) (3)	A1	J
142	145	Abflugzeit-Hin	A4	0800
146	149	Ankunftzeit-Hin	A4	1200
150	153	Abflugzeit-Rück	A4	1300
154	157	Ankunftzeit-Rück	A4	1800
158	162	Flugnummer Hin	A5	4886
163	167	Flugnummer Rück	A5	4887
168	169	Reisetyp. TO = pauschal EA = eigene Anreise NF = NurFlug	A2	TO
170	170	Kennzeichnung Übernachtflug (J/N). Wenn J, dann gilt Hotelantrittstermin = Angebotstermin + 1.	A1
171	180	Im Vollzahlerpreis enthaltener Frühbucherrabatt (Absolutbetrag).	N10	0000000075
181	184	Preis-Incentives 1 bis 3. Die Codes können über die Umsetzungstabelle CODES-INCENTIVES-spra sprachabhängig in Langtexte übersetzt werden.	N4	2135
185	188		N4	0000
189	192		N4	0000
193	195	Verfügbare Flugplätze. Maximal wird 9 zurückgegeben.	N3	009
196	198	Verfügbare Zimmer. Maximal wird 9 zurückgegeben.	N3	004
199	200	Filler für zukünftige Erweiterungen.	A02

(*)Bei diesen Feldern handelt es sich um keine Schlüsselfelder, sondern Attribute.
Hinweise

Die Anzahl der verfügbaren Flugplätze ist u.U. die Summe der verfügbaren Flugplätze mehrerer Verbindungen (kumulierte Verfügbarkeitsprüfung). Die sonstigen Fluginfos (Flugnummern, Flugzeiten etc.) beziehen sich immer nur auf eine Verbindung. Erst bei der Buchung wird endgültig entschieden, welche Verbindung gewählt wird.
Es werden grundsätzlich nur Flüge mit der Beförderungsnummer = 1 und Beförderungsklasse = 2 berechnet.
Bus- und Zugbeförderungen werden zurzeit wie eigene Anreise berechnet, eine Prüfung der Beförderungsverfügbarkeit findet nicht statt.

6Umsetzungstabellen
Die folgenden Umsetzungstabellen werden sprachabhängig ausgeliefert. Das Kürzel spra beinhaltet den ISO-Sprachencode und kann zurzeit folgende Ausprägungen haben:

DE deutsch
FR französisch
HU ungarisch
NL niederländisch
NLBflämisch (nicht ISO-konform, da es für flämisch keinen ISO-Code gibt)
PL polnisch

Zimmerausstattungen
Die Dateien werden unter folgenden Namen ausgeliefert:
CODES-AUSSTATT-spra.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	002	Ausstattungscode	A2	BG
003	003	Trennzeichen	A1
004	033	Langtext	A30	Balkon oder Garten

Zimmerklassifikationen
Die Dateien werden unter folgenden Namen ausgeliefert:
CODES-KLASSIF-spra.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	002	Klassifikationscode	A2	F4
003	003	Trennzeichen	A1
004	043	Langtext Singular	A40	Ferienhaus für 4 Personen
044	044	Trennzeichen	A1
045	084	Langtext Plural	A40	Ferienhäuser für 4 Personen

Unterkunftsarten
Die Dateien werden unter folgenden Namen ausgeliefert:
CODES-UNTERKUNFT-spra.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	002	Code Unterkunftsart	A2	AM
003	003	Trennzeichen	A1
004	033	Langtext	A30	Apartments

Hotelmerkmale
Die Dateien werden unter folgenden Namen ausgeliefert:
CODES-MERKMALE-spra.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	002	Code Merkmal	A4	A8WE
003	003	Trennzeichen	A1
004	043	Langtext	A40	Wellness

Incentives
Die Dateien werden unter folgenden Namen ausgeliefert:
CODES-INCENTIVES-spra.zip

Spalte		Feld	Format	Beispiel
Von	Bis
001	004	Preisnummer	N4	2280
005	005	Trennzeichen	A1
008	037	Text	A30	14 Tage zum 12-Tage-Preis

7XML-Begleitdokument
Die Dateien werden unter folgenden Namen ausgeliefert:
ANGEBOTE-BEGLEITINFO-Dn.zip
Die folgende Liste beschreibt die XML-Tags und ihre logische Abhängigkeit zueinander. Es existiert auch eine XSD-Datei, die bei Bedarf zur Verfügung gestellt werden kann.

XML-Tag	Stufe	M/O	Anz	L	Datentyp	Erläuterungen
<Begleitinfo Version="01.0.0" Absender="Thomas Cook AG">
<Titel>	1	M	1	50	alphanum	Überschrift
<Dateiliste>	1	M	1			Beginn der Dateiliste
<Datei>	2	M	n	40	alphanum	Dateiname
<Erstellungsdatum>	1	M	1	10	tt.mm.jjjj	Erstellungsdatum und -zeit des Begleitdokumentes
<Erstellungszeit>	1	M	1	5	hh:mm
<Katalogliste>	1	M	1			Beginn der katalogspezifischen Angaben
…<Katalog>	2	M	n
……<Katalogname>	3	M	1	9	alphanum
……<Buchungsdatum>	3	M	1	10	tt.mm.jjjj
……<Filter>	3	M	1			Beginn der Filterkriterien
………<Zielvon>	4	M	1	3	alphanum	Reisezielrange, z.B. A bis Z99.
………<Zielbis>	4	M	1	3	alphanum
………<Datumvon>	4	M	1	10	tt.mm.jjjj	Datumrange, z.B. 01.11.2006 bis 31.10.2007.
………<Datumbis>	4	M	1	10	tt.mm.jjjj
………<Dauervon>	4	O	1	3	num	Dauernrange, z.B. 7 bis 21.
………<Dauerbis>	4	O	1	3	num
………<Dauernliste>	4	O	1			Alternativ: diskrete Dauern, z.B. 5, 7, 10, 14.
…………<Dauer>	5	O	1-9	3	num
……<Errataliste>	3	O	1			Angaben zu nicht gelieferten Angeboten
………<Errata>	4	O	n
…………<Zielvon>	5	O	1	3	alphanum
…………<Zielbis>	5	O	1	3	alphanum
…………<Datumvon>	5	O	1	10	tt.mm.jjjj
…………<Datumbis>	5	O	1	10	tt.mm.jjjj
…………<Dauervon>	5	O	1	3	num
…………<Dauerbis>	5	O	1	3	num
…………<Dauernliste>	5	O	1
……………<Dauer>	6	O	1-9	3	num
…………<Beftyp>	5	O	1	1	alphanum	Beförderungstyp
…………<Befoab>	5	O	1	3	alphanum	Abflughafen
…………<Befoan>	5	O	1	3	alphanum	Zielflughafen
…………<Angebot>	5	O	1	5	alphanum
…………<Untbrtyp>	5	O	1	1	alphanum
…………<Zimmerart>	5	O	1	1	alphanum
…………<Zimmertyp>	5	O	1	1	alphanum

Legende
StufeVerdeutlichung, zu welcher Gruppe ein Element gehört
M/OAngabe, ob es sich um ein Mussfeld oder ein optionales Feld handelt.
AnzAnzahl der Elemente (n = beliebig)
LMaximallänge der Daten