# XML (english) ## Character Encoding and XML Structure The character encoding of the data is - as with the live interface `UTF-8`. The file starts with the XML header: `` Then follows the array `<meldescheine />` with at least one registration form` ` This contains the data of the main guest (see field definitions) and optionally an array of accompanying persons ```.

The sequence of the data can be in any order.

This results in the following structure: ```xml ```

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

Feld	Datentyp	Erklärung
`anreise`	date	Arrival date of the guest in the format `YYYY-MM-DD`
`abreise`	date	Departue Date of the guest in the format `YYYY-MM-DD`
`kategorie`	string	The ID of the tariff to be booked (can be viewed via API or via the web interface)

## Individual Fields All other fields are defined individually for each municipality. Whether these are mandatory or optional fields can be found in the definition of the municipalities. #### Feldzuweisung

An assignment of the fields of the posting system to the import interface can be stored in the system. Thus it is not absolutely necessary to make adjustments to the generation of the XML data set

#### Mandatory Fields

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

## Tariff Assignments

The correct tariff allocation is essential for a correct booking of the guests. If existing XML files are to be taken over from a legacy system, it is **imperative** that they be adapted.

[![image-1601979321078.png](https://s3-eu-central-1.amazonaws.com/wiki.meldescheine.de/uploads/images/gallery/2020-10/scaled-1680-/image-1601979321078.png)](https://s3-eu-central-1.amazonaws.com/wiki.meldescheine.de/uploads/images/gallery/2020-10/image-1601979321078.png) The tariffs of the guests are transferred from the field kategorie. The value from the `id` field (see below) is used for this. In the example below, a guest with the Erwachsener (Adult)" tariff would have to be transferred as follows: `1`

Tariff assignments can be requested from your contact person or - if you have been activated for this - can be seen in the "my profile" area on the web interface.

[![image-1601978889220.png](https://s3-eu-central-1.amazonaws.com/wiki.meldescheine.de/uploads/images/gallery/2020-10/scaled-1680-/image-1601978889220.png)](https://s3-eu-central-1.amazonaws.com/wiki.meldescheine.de/uploads/images/gallery/2020-10/image-1601978889220.png) ## Accompanying Persons ccompanying persons of a registration form can be posted via the tag ``. Thus any number of accompanying persons can be booked. All defined fields of the main guest can also be used for accompanying persons.

The field `kategorie` must also **always be** filled in for accompanying persons .

If arrival or departure ( `anreise`, `abreise`) is not specified for the accompanying persons, these will be taken over by the main guest.

### Example accompanying persons

XML

``` 2019-11-22 2019-11-25 1 2019-11-22 2019-11-23 1 ```

## Example booking An example of a booking from a registration form with: - 1 registration form - Main guest with personal data - An accompanying person

XML

```xml

.

Herr

Mustermann

Max

123456

Musterstadt

Deutschland

2019-10-19

2019-10-20

1

Frau

Mustermann

Karin

1

2019-10-19

2019-10-20

```