XML-en

ZeichensatzCharacter undEncoding and XML StrukturStructure

DerThe Zeichensatzcharacter derencoding Datenof istthe data is - wieas auchwith beithe derlive Live-Schnittstelle UTF-8interface `UTF-8`. DieThe Dateifile beginntstarts mitwith demthe XML Header: header: `<?xml version="1.0" encoding="UTF-8"?>`

Dann 

Then dasfollows Array the array `<meldescheine  /> mit` mindestenswith einemat Meldeschein least one registration form `<meldeschein  /> Darin` enthaltenThis sindcontains diethe Datendata desof Hauptgastesthe main guest (siehesee Felddefintionen)field unddefinitions) optionaland einemoptionally Arrayan ausarray Begleitpersonen of accompanying persons `<begleitperson  />`.

Die 

The könnensequence of the data can be in beliebigerany Reihenfolge stehen, solange die Struktur korrekt ist.order.

SomitThis ergibtresults sichin folgendethe Struktur:following structure:

<?xml version="1.0" encoding="UTF-8"?>
<meldescheine>
   <!-- Meldeschein 2 -->
   <meldeschein>
      <!-- Daten Hauptgast -->
      <begleitperson>
         <!-- Daten Begleiter 1-->
      </begleitperson>
      <begleitperson>
         <!-- Daten Begleiter 2-->
      </begleitperson>
   </meldeschein>
   <!-- Meldeschein 2 -->
   <meldeschein>
      <!-- Daten Hauptgast -->
      <begleitperson>
         <!-- Daten Begleiter 1-->
      </begleitperson>
      <begleitperson>
         <!-- Daten Begleiter 2-->
      </begleitperson>
   </meldeschein>
</meldescheine>

PflichtfelderMandatory fields

Folgende Felder werden unabhängig der Gemeindedefinition (s.u.) immer benötigt um eine Mindest-Information für die Kurtaxeberechnung zu besitzen.

IndividuelleIndividual FelderFields

AlleAll weiterenother Felderfields derare sinddefined jeindividually Gemeindefor individuelleach definiert.municipality. ObWhether esthese sichare hierbeimandatory umor Pflichtfelderoptional oderfields optionalecan Felderbe handeltfound istin derthe Gemeinden-Definitiondefinition zuof entnehmen.the municipalities.

Feldzuweisung

EineAn Zuweisungassignment derof Felderthe derfields Buchungs-Systemsof zurthe Import-Schnittstelleposting wirdsystem imto Systemthe jeimport Gemeindeinterface hinterlegtcan werden.be Somit ist i.d.R. keine Anpassung der XML-Datei notwendig (Ausnahme - Tarife (siehe Kapitel "Tarifzuweisung")

Je nach Definition der Gemeinde können Felderstored in derthe XML-Dateisystem. existierenThus welcheit beimis Importnot nichtabsolutely innecessary dasto Systemmake eingespieltadjustments werden.to the generation of the XML data set

PflichtfelderMandatory der GemeindeFields

Sind bestimmte Daten einer Gemeinde als Pflichtfeld definiert, so müssen diese ebenfalls in der XML-Datei übergeben werden.

TarifzuweisungTariff Assignments

DieThe korrektecorrect Tarifzuweisungtariff istallocation unabdingbaris füressential einefor korrektea Buchungcorrect derbooking Gäste.of Solltenthe existierendeguests. XML-DateienIf ausexisting einemXML Altsystemfiles übernommenare werden,to sobe müssentaken dieseover from a legacy system, it is zwingendimperative angepasstthat werden.they be adapted.

DieThe Tarifetariffs derof Gästethe werdenguests ausare demtransferred Feldfrom kategoriethe übertragen.field Dazukategorie. wirdThe dervalue Wertfrom aus dem Feldthe "id" field (s.u.)see verwendet.below) is used for this.
ImIn u.g.the Beispielexample wärebelow, alsoa einguest Gastwith mit Tarifthe "Erwachsener"Adult" wietariff folgtwould zuhave übergeben:to be transferred as follows:

<kategorie>1</kategorie>

TarifzuweisungenTariff könnenassignments übercan Ihrenbe Ansprechpartnerrequested angefordertfrom werdenyour odercontact sindperson or - sofernif Sieyou dafürhave freigeschaltetbeen sindactivated imfor Bereichthis - can be seen in the "meinmy Profil"profile" überarea dieon Web-Oberflächethe ersichtlich.web interface.

BegleitpersonenAccompanying Persons

Begleitpersonenccompanying einespersons Meldescheinsof könnena überregistration dasform Tag can be posted via the tag <begleitperson  /> gebucht. werden.Thus Somitany könnennumber eineof beliebigeaccompanying Anzahlpersons ancan Begleiternbe gebuchtbooked. werden.All Alledefined definiertenfields Felderof desthe Hauptgastesmain könnenguest ebenfallscan füralso Begleiterbe verwendetused werden.for accompanying persons.

DasThe Feld field  kategorie müssenmust beialso always Begleitpersonenbe  filled in ebenfalls immerfor accompanying persons  befüllt sein..

SolltenIf An-arrival oderor Abreisedeparture ( anreise,  abreise) beiis dennot Begleitpersonenspecified nichtfor angegebenthe sein,accompanying sopersons, werdenthese diesewill vombe Hauptgasttaken übernommen.over by the main guest.

BeispielExample Begleitpersonenaccompanying persons

    <!-- ... -->
    <meldeschein>
        <!-- Daten des Hauptgastes -->
        <anreise>2019-11-22</anreise>
        <abreise>2019-11-25</anreise>
        <kategorie>1</kategorie>
        <!-- Ende Daten des Hauptgastes -->
        <begleitperson>
            <anreise>2019-11-22</anreise>
            <abreise>2019-11-23</anreise>
            <kategorie>1</kategorie>
            <! -- optionale weitere Daten -->
        </begleitperson>
        <begleitperson>
            <!-- weiterer Begleiter-->
        </begleitperson>
        <begleitperson>
            <!-- weiterer Begleiter-->
        </begleitperson>
   </meldeschein>
<!-- ... -->

Beispiel-BuchungExample booking

EinAn Beispielexample einerof Buchunga vonbooking einemfrom Meldescheina mit:registration form with:

• 1 Meldescheinregistration form
  • HauptgastMain mitguest Personendatenwith personal data
  • EinerAn Begleitpersonaccompanying person

<?xml version="1.0" encoding="UTF-8"?>
<meldescheine>
   <meldeschein>
      <hausnummer>.</hausnummer>
      <anrede>Herr</anrede>
      <name>Mustermann</name>
      <vorname>Max</vorname>
      <plz>123456</plz>
      <ort>Musterstadt</ort>
      <land>Deutschland</land>
      <anreise>2019-10-19</anreise>
      <abreise>2019-10-20</abreise>
      <kategorie>1</kategorie>
      <begleitperson>
         <anrede>Frau</anrede>
         <name>Mustermann</name>
         <vorname>Karin</vorname>
         <kategorie>1</kategorie>
         <anreise>2019-10-19</anreise>
         <abreise>2019-10-20</abreise>
      </begleitperson>
   </meldeschein>
</meldescheine>