Für den Bezug von Factsheets benötigen Sie eine separate Freischaltung, wenden Sie sich hierfür bitte an <sales@giata.com>.

Der Zugriff auf die Ressourcen dieses Webservice ist passwortgeschützt über die HTTP Basic-Authentifizierung. Der Benutzername für die Authentifizierung ist die in der Freischaltmail mitgeteilte "Fact User ID".

Das Passwort bestimmen Sie selbst über den "Link zum Passwort setzen" in der Freischaltmail.

Codebeispiel 1 für die Authentifizierung per shell/curl:

curl --user "your-uid":"your-password" 'https://xml.giatamedia.com/?...'

Codebeispiel 2 für die Authentifizierung per php:

<?php
  $username = "your-uid";
  $password = "your-password";
  $remote_url = 'https://xml.giatamedia.com/?...';

  $opts = array('http'=>array('method'=>"GET",
                'header' => "Authorization: Basic ". base64_encode("$username:$password")));

  $context = stream_context_create($opts);
  $file = file_get_contents($remote_url, false, $context);
  print($file);

Die Factsheets erhalten sie über http-Links, wobei diese Links von der GIATA-XML-Schnittstelle ausgeliefert werden. Es muss also in einem ersten Schritt der Link zum Factsheet ermittelt werden, um in einem zweiten Schritt das Factsheet selbst abzurufen.

Um die Factsheet-Links zu erhalten, geben Sie bei der GIATA-XML-Schnittstelle den zusätzlichen "show"-Parameter "fact" an, die XML-Schnittstelle wird dabei wie gewohnt abgefragt, siehe Dokumentation GIATA-XML-Schnittstelle .

An den zurückgelieferten Factsheet-Link müssen Sie anschliessend noch Ihre XML-Zugangsdaten anhängen.

Beispiel, um ein Factsheet-Link zu einem Veranstaltercode und einen Buchungscode zu erhalten. Als Veranstaltercode wird dabei "NEC" benutzt, als Buchungscode "11006A".

https://xml.giatamedia.com/?sc=hotel&vc=NEC&oc=11006A&show=fact,hn,vn

Die XML-Ausgabe sieht so aus:

<result found="1">
<data id="0">
<Factsheet>https://xml.giatamedia.com/?sc=fact&khid=3200166</Factsheet>
<Hotelname>Hotel Don Antonio</Hotelname>
<Veranstaltername>Neckermann</Veranstaltername>
</data>
</result>

Nun extrahieren Sie den Factsheet-Link und hängen daran Ihre XML-Zugangsdaten und mit diesem Link können Sie dann das Factsheet abrufen. Im Beispiel sieht der Factsheet-Link dann so aus:

https://xml.giatamedia.com/?sc=fact&khid=4253456

Das Spiegeln der Facts erfolgt in zwei Stufen. In einem ersten Schritt beziehen Sie einen initialen Dump der Factsheets, anschliessend beziehen Sie in bestimmten Intervallen die Update-Links.

<FactUpdateList found="169" modifiedStart="1287011826001" modifiedEnd="1287357085000">
<data id="1">                    <!-- Factsheet update -->
<KataloghotelID>3200090</KataloghotelID>
<Factsheet>https://xml.giatamedia.com/?sc=fact&khid=3200090</Factsheet>
</data>
<data id="2" status="deleted">   <!-- Factsheet löschen -->
<KataloghotelID>2611207</KataloghotelID>
</data>
...
</FactUpdateList>

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<factsheet created="2010-08-09T14:28:00+02:00" itemId="3200166" itemName="Hotel Don Antonio"
  catId="8182" catName="Preisknüller - Spanien &amp; Portugal Sommer 2010"
  provId="186" provCode="NEC" provName="Neckermann"
  giataId="11632">
  <item>
  <bookingCodes>
   <bookingCode seq="1">11006A</bookingCode>
  </bookingCodes>
  </item>
  <factset>
    <factgroup name="buildinginformation" code="14">
      <fact name="buildinginformation:numfloorsmain" code="312" sources="generic">
        <attributes>
          <attribute name="number" code="49" value="4"/>
        </attributes>
      </fact>
      <fact name="buildinginformation:numroomsdouble" code="314" sources="generic">
        <attributes>
          <attribute name="number" code="49" value="151"/>
        </attributes>
      </fact>
      <fact name="buildinginformation:numroomstotal" code="316" sources="generic">
        <attributes>
          <attribute name="number" code="49" value="310"/>
        </attributes>
      </fact>
      <fact name="buildinginformation:yearconstruction" code="320" sources="generic">
        <attributes>
          <attribute name="year" code="50" value="2000"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="category" code="15">
      <fact name="category:official" code="325" sources="generic">
        <attributes>
          <attribute name="rating" code="56" value="4"/>
        </attributes>
      </fact>
      <fact name="category:recommended" code="326" sources="provider">
        <attributes>
          <attribute name="rating" code="56" value="4"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="distance" code="13">
      <fact name="distance:golfcourse" code="294" sources="generic">
        <attributes>
          <attribute name="distance" code="15" value="7000" unit="meter"/>
        </attributes>
      </fact>
      <fact name="distance:publictransport" code="298" sources="generic">
        <attributes>
          <attribute name="distance" code="15" value="500" unit="meter"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="entertainment" code="2">
      <fact name="entertainment:entertainment" code="2" sources="generic"/>
      <fact name="entertainment:miniclub" code="7" sources="generic"/>
    </factgroup>
    <factgroup name="facilities" code="3">
      <fact name="facilities:aircon" code="8" sources="generic"/>
      <fact name="facilities:bar" code="14" sources="provider generic"/>
      <fact name="facilities:bicyclestorageroom" code="16" sources="provider generic"/>
      <fact name="facilities:carpark" code="22" sources="generic"/>
      <fact name="facilities:childrenspool" code="26" sources="provider generic"/>
      <fact name="facilities:conferencerooms" code="28" sources="generic"/>
      <fact name="facilities:deckchairs" code="30" sources="provider generic"/>
      <fact name="facilities:elevators" code="33" sources="provider"/>
      <fact name="facilities:foyer" code="322" sources="provider"/>
      <fact name="facilities:garden" code="40" sources="provider"/>
      <fact name="facilities:indoorpool" code="43" sources="provider generic"/>
      <fact name="facilities:internetaccess" code="44" sources="generic"/>
      <fact name="facilities:outdoorpool" code="50" sources="provider"/>
      <fact name="facilities:parasols" code="52" sources="provider generic"/>
      <fact name="facilities:playground" code="56" sources="provider generic"/>
      <fact name="facilities:pool" code="58" sources="generic">
        <attributes>
          <attribute name="freshwater" code="51"/>
        </attributes>
      </fact>
      <fact name="facilities:poolbar" code="59" sources="generic"/>
      <fact name="facilities:reception" code="62" sources="provider"/>
      <fact name="facilities:receptionarea" code="63" sources="provider generic"/>
      <fact name="facilities:restaurant" code="65" sources="provider"/>
      <fact name="facilities:roomservice" code="66" sources="generic"/>
      <fact name="facilities:sunterrace" code="76" sources="provider generic"/>
      <fact name="facilities:towels" code="80" sources="provider"/>
      <fact name="facilities:tvroom" code="83" sources="provider generic"/>
    </factgroup>
    <factgroup name="location" code="5">
      <fact name="location:beach" code="89" sources="provider">
        <attributes>
          <attribute name="distance" code="15" value="1200" unit="meter"/>
        </attributes>
      </fact>
      <fact name="location:centrallysituated" code="90" sources="provider">
        <attributes>
          <attribute name="distance" code="15" value="800" unit="meter"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="meals" code="6">
      <fact name="meals:breakfast" code="96" sources="generic">
        <attributes>
          <attribute name="buffet" code="7"/>
        </attributes>
      </fact>
      <fact name="meals:dinner" code="100" sources="generic">
        <attributes>
          <attribute name="buffet" code="7"/>
        </attributes>
      </fact>
      <fact name="meals:halfboard" code="103" sources="provider generic"/>
      <fact name="meals:specialoffers" code="113" sources="generic"/>
    </factgroup>
    <factgroup name="objectinformation" code="16">
      <fact name="objectinformation:address" code="328" sources="generic">
        <attributes>
          <attribute name="street" code="58" value="C./ Bonavida"/>
          <attribute name="streetnumber" code="59" value="8"/>
          <attribute name="cityname" code="60" value="Peguera"/>
          <attribute name="postalcode" code="61" value="07181"/>
          <attribute name="country" code="62" value="ES"/>
          <attribute name="addresslines" code="63" value="C./ Bonavida 8  07181 Peguera"/>
        </attributes>
      </fact>
      <fact name="objectinformation:email" code="331" sources="generic">
        <attributes>
          <attribute name="value" code="64" value="hotel@hoteldonantonio.com"/>
        </attributes>
      </fact>
      <fact name="objectinformation:fax" code="330" sources="generic">
        <attributes>
          <attribute name="value" code="64" value="+34971033000"/>
        </attributes>
      </fact>
      <fact name="objectinformation:phone" code="329" sources="generic">
        <attributes>
          <attribute name="value" code="64" value="+34971033033"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="payment" code="8">
      <fact name="payment:payment" code="117" sources="generic">
        <attributes>
          <attribute name="visa" code="41"/>
          <attribute name="mastercard" code="24"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="rooms" code="9">
      <fact name="rooms:aircon" code="120" sources="provider"/>
      <fact name="rooms:balcony" code="123" sources="provider generic"/>
      <fact name="rooms:bathroom" code="125" sources="provider generic"/>
      <fact name="rooms:fridge" code="143" sources="generic"/>
      <fact name="rooms:hairdryer" code="145" sources="provider generic"/>
      <fact name="rooms:heating" code="146" sources="generic">
        <attributes>
          <attribute name="central" code="48"/>
        </attributes>
      </fact>
      <fact name="rooms:internetaccess" code="148" sources="generic"/>
      <fact name="rooms:minibar" code="156" sources="provider generic"/>
      <fact name="rooms:phone" code="159" sources="provider"/>
      <fact name="rooms:radio" code="162" sources="generic"/>
      <fact name="rooms:safe" code="163" sources="provider generic"/>
      <fact name="rooms:shower" code="166" sources="provider"/>
      <fact name="rooms:terrace" code="173" sources="provider"/>
      <fact name="rooms:tv" code="176" sources="provider">
        <attributes>
          <attribute name="sat" code="34"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="spa" code="10">
      <fact name="spa:massage" code="195" sources="provider">
        <attributes>
          <attribute name="forafee" code="20"/>
        </attributes>
      </fact>
      <fact name="spa:sauna" code="196" sources="provider">
        <attributes>
          <attribute name="freeofcharge" code="21"/>
        </attributes>
      </fact>
      <fact name="spa:steambath" code="198" sources="generic"/>
      <fact name="spa:whirlpool" code="201" sources="provider">
        <attributes>
          <attribute name="freeofcharge" code="21"/>
        </attributes>
      </fact>
    </factgroup>
    <factgroup name="sports" code="11">
      <fact name="sports:aerobics" code="202" sources="generic"/>
      <fact name="sports:beachvolleyball" code="209" sources="generic"/>
      <fact name="sports:biking" code="210" sources="provider">
        <attributes>
          <attribute name="forafee" code="20"/>
        </attributes>
      </fact>
      <fact name="sports:billiard" code="211" sources="provider">
        <attributes>
          <attribute name="forafee" code="20"/>
        </attributes>
      </fact>
      <fact name="sports:boccia" code="212" sources="provider">
        <attributes>
          <attribute name="freeofcharge" code="21"/>
        </attributes>
      </fact>
      <fact name="sports:golf" code="219" sources="provider"/>
      <fact name="sports:gym" code="220" sources="provider">
        <attributes>
          <attribute name="freeofcharge" code="21"/>
        </attributes>
      </fact>
      <fact name="sports:tabletennis" code="244" sources="provider">
        <attributes>
          <attribute name="freeofcharge" code="21"/>
        </attributes>
      </fact>
      <fact name="sports:tennis" code="245" sources="generic"/>
    </factgroup>
  </factset>
</factsheet>

Das Wurzelelement <factsheet> kann die folgenden Attribute enthalten:

Wenn vorhanden, werden Buchungscodes innerhalb der item-node nach dem Wurzelelement ausgegeben.

Das Wurzelelement <factsheet> kann ein oder mehrere Elemente <factset> enthalten.

Jedes Element <factset> enthält ein oder mehrere Elemente <factgroup>.

Das Element <factgroup> kann die folgenden Attribute enthalten:

Jedes Element <factgroup> enthält ein oder mehrere Elemente <fact>.

Das Element <fact> kann die folgenden Attribute enthalten:

Jedes Element <fact> kann ein Element <attributes> enthalten, welches wiederum ein oder mehrere Elemente <attribute> enthält.

Das Element <attribute> kann die folgenden Attribute enthalten:

Die Beschreibung der möglichen Werte kann hier abgerufen werden:

https://xml.giatamedia.com/dokumentation/GIATA-Facts/definitions.xml

Auszug:

<?xml version="1.0" encoding="UTF-8"?>
<factdefintions>
  <factgroups>
    <!-- ... -->
    <factgroup code="3" name="facilities">
      <label lang="de">Ausstattung</label>
      <label lang="en">Facilities</label>
      <facts>
        <fact code="8" name="facilities:aircon">
          <label lang="de">Klimaanlage</label>
          <label lang="en">Air conditioning</label>
        </fact>
        <fact code="9" name="facilities:auditorium">
          <label lang="de">Theatersaal</label>
          <label lang="en">Auditorium</label>
        </fact>
        <fact code="10" name="facilities:babysitter">
          <label lang="de">Babysitter</label>
          <label lang="en">Babysitter</label>
        </fact>
        <!-- ... -->
      </facts>
    </factgroup>
    <!-- ... -->
    <factgroup code="9" name="rooms">
      <label lang="de">Zimmer</label>
      <label lang="en">Rooms</label>
      <facts>
        <fact code="118" name="rooms:adapterplug">
          <label lang="de">Steckdosenadapter</label>
          <label lang="en">Electrical outlet adapter</label>
        </fact>
        <fact code="119" name="rooms:additionalbed">
          <label lang="de">Zustellbett</label>
          <label lang="en">Extra bed</label>
        </fact>
        <fact code="120" name="rooms:aircon">
          <label lang="de">Klimaanlage</label>
          <label lang="en">Air conditioning</label>
        </fact>
        <!-- ... -->
      </facts>
    </factgroup>
    <!-- ... -->
  </factgroups>
  <attributes>
    <!-- ... -->
    <attribute code="2" name="alacarte">
      <label lang="de">à la carte</label>
      <label lang="en">à la carte</label>
    </attribute>
    <attribute code="3" name="allowed">
      <label lang="de">erlaubt</label>
      <label lang="en">allowed</label>
    </attribute>
    <!-- ... -->
  </attributes>
  <units>
    <unit name="hour">
      <label lang="de">Stunden</label>
      <label lang="en">hours</label>
    </unit>
    <unit name="meter">
      <label lang="de">Meter</label>
      <label lang="en">metres</label>
    </unit>
    <unit name="sqm">
      <label lang="de">Quadratmeter</label>
      <label lang="en">square metres</label>
    </unit>
  </units>
</factdefintions>

Das Wurzelelement <factdefintions> enthält die Elemente <factgroups>, <attributes> und <units>.

Das Element <factgroups> enthält mehrere Elemente <factgroup> mit den folgenden Attribute:

Das Element <factgroup> enthält ein oder mehrere Element <label>. <label> enthält ein Attribut lang mit der Sprache und hat als Inhalt den Begriff für die entsprechende Gruppe von Facts in der jeweiligen Sprache.

Das Element <factgroup> enthält zudem ein oder mehrere Elemente <fact>. <fact> hat analog die Attribute code und name, außerdem ein oder mehrere Elemente <label>.

Das Element <attributes> enthält mehrere Element <attribute> mit den Attributen code und name, außerdem ein oder mehrere Elemente <label>.

Das Element <units> enthält mehrere Element <unit> mit dem Attributen name, außerdem ein oder mehrere Elemente <label>.