# Meldescheine buchen

<div id="bkmrk-"></div><table class="codehilitetable" id="bkmrk-post-meldeschein%2Fbuc"><tbody><tr><td class="code">```
POST  import/meldeschein/buchen/
```

</td></tr></tbody></table>

Dieser Aufruf erzeugt einen oder mehrere elektronischen Meldeschein im System.

## Allgemein

Es ist möglich mehrere Meldescheine auf einmal zu buchen, indem weitere Objekte dem `<span class="n">meldescheine</span>` Array hinzugefügt werden.

## Parameter

<div id="bkmrk-name-datentyp-verwen"><div><table><thead><tr><th>Name</th><th>Datentyp</th><th>Verwendung</th></tr></thead><tbody><tr><td>meta</td><td>object</td><td>[Meta-Objekt](https://wiki.meldescheine.de/books/api/page/meta-objekt "Meta Objekt")</td></tr><tr><td>params</td><td>object</td><td>Optionale Parameter</td></tr><tr><td>meldescheine</td><td>array</td><td>Array mit Meldescheindaten</td></tr><tr><td>meldescheine\[\]</td><td>object</td><td>Die zu buchenden Daten des Meldescheins</td></tr><tr><td>meldescheine\[\].personen</td><td>array</td><td>Auflistung aller Gäste</td></tr><tr><td>meldescheine\[\].ms\_type</td><td>string</td><td>Immer mit dem Wert "ems" zu befüllen</td></tr></tbody></table>

</div></div>### Pro Person

<div id="bkmrk-name-datentyp-verwen-0"><div><table><thead><tr><th>Name</th><th>Datentyp</th><th>Verwendung</th></tr></thead><tbody><tr><td>meldescheine\[\].personen\[\].tarif\_id</td><td>int</td><td>Die Tarif-ID des Gasts</td></tr><tr><td>meldescheine\[\].personen\[\].gast\_type</td><td>string</td><td>Gast-Art (`<span class="n">person</span>`, `<span class="n">gruppe</span>` )</td></tr><tr><td>meldescheine\[\].personen\[\].arrival\_date</td><td>date</td><td>Anreisedatum des Gasts</td></tr><tr><td>meldescheine\[\].personen\[\].departure\_date</td><td>date</td><td>Abreisedatum des Gasts</td></tr></tbody></table>

</div></div>#### Einzel-Person

<div id="bkmrk-name-datentyp-verwen-1"><div><table><thead><tr><th>Name</th><th>Datentyp</th><th>Verwendung</th></tr></thead><tbody><tr><td>meldescheine\[\].personen\[\].\*</td><td>string</td><td>Weitere definierte Felder. (nach Definition)</td></tr></tbody></table>

</div></div><p class="callout info">Die Definition der Felder hängt von der Gemeinde ab und können über den Aufruf [`<span class="o">/</span><span class="n">get_current_user</span>`](https://wiki.meldescheine.de/books/api/page/konfiguration-abrufen "Konfiguration abrufen") abgefragt werden.</p>

#### Reisegruppe

<div id="bkmrk-name-datentyp-verwen-2"><div>  
</div><div><table><thead><tr><th>Name</th><th>Datentyp</th><th>Verwendung</th></tr></thead><tbody><tr><td>meldescheine\[\].personen\[\].anzahl</td><td>int</td><td>Anzahl der Gäste</td></tr></tbody></table>

</div></div><div id="bkmrk--0"></div><p class="callout warning">Wenn das Feld meldescheine\[\].personen\[\].anzahl größer 1 ist ,wird der Meldeschein als Gruppenmeldeschein verbucht. Eventuell übergebene Einzelinformationen für den Gast (Vorname,Nachname etc.) werden nicht gespeichert.</p>

### Optionale Parameter (`params`)

<table border="1" id="bkmrk-name-datentyp-beschr" style="border-collapse: collapse; width: 100%; height: 47px;"><tbody><tr style="height: 18px;"><td style="width: 33.3333%; height: 18px;">Name</td><td style="width: 33.3333%; height: 18px;">Datentyp</td><td style="width: 33.3333%; height: 18px;">Beschreibung</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">append\_pdf</td><td style="width: 33.3333%; height: 29px;">bool</td><td style="width: 33.3333%; height: 29px;">Für bei der Response jedem Meldeschein-Objekt den Parameter "pdf" .</td></tr></tbody></table>

##### `params.append_pdf`

Dieser Schalter ermöglicht es, jedem Meldeschein-Objekt direkt das PDF anzufügen.   
In der Server-Antwort wird das Feld `pdf` angefügt, welches den Base64-kodierten Meldescheine enthält.

<p class="callout danger">Das aktivieren dieses Schalters gilt als Druckvorgang und wird entsprechend protokolliert - siehe Erklärung [hier](https://wiki.meldescheine.de/books/api/page/meldeschein-kurkarte-abrufen-%28pdf%29 "Meldeschein-Kurkarte abrufen (PDF)").</p>

##### Beispiel

```JSON
{
	"meta": {
		"gemeinde": 1,
		"requestId": "123-456-789",
		"idempotent": true,
		"objekt": 2049
	},
	"params": {
		"append_pdf": true
	},
    ....
 }
```

```JSON
{
    "meta": {
        "gemeinde": 1,
        "requestId": "123-456-789",
        "idempotent": true,
        "objekt": 2049,
        "timestamp": "2020-12-18T11:51:41.154820",
        "user": {
            "id": 38,
            "username": "DemoV",
            "alias": "Lisa Mustermann"
        }
    },
    "status": "success",
    "meldescheine": [
        {
            "meldeschein": {
                "id": 28,
             	//....
            },
            "id": 28,
            "pdf": "JVBERi0xLjMKMSAwIG9iago8PAov....." 
        }
    ]
}
```

## Server Antwort

Die Serverantwort gibt im Erfolgsfall ein Array aus `<span class="n">meldeschein</span>` Objekten mit der dem gesamten Meldeschein-Objekt zurück.

<p class="callout warning">Der Anwort-Aufbau entspricht dem aus dem Meldeschein aktuaklisieren [/get](https://wiki.meldescheine.de/books/api/page/meldescheindaten-abrufen "Meldescheindaten abrufen") Aufruf</p>

<p class="callout info">Die Reihenfolge der Personen ist zwischen Anfrage und Antwort immer gleichbleibend. Somit können Sie die die ID's der Personen in Ihrem System für spätere Aktualisierungen mitführen</p>

Response:

<div id="bkmrk-json"><div><label for="__tab_1_0">JSON</label></div></div>```JSON
{
  "meta": {
    "requestId": "5ca0b885-11e3-4abd-9e60-cb8265ea9899",
    "timestamp": "2019-10-24T14:06:10.673840",
    "user": {
      "id": 14,
      "username": "api_demo",
      "first_name": "API",
      "last_name": "Demo",
      "email": "api_demo@apidemo.de",
      "is_active": true,
      "user_type": "beherberger",
      "alias": "API Demo",
      "last_login": "2019-10-24T11:35:18.015947+02:00"
    },
    "gemeinde": 1
  },
  "status": "success",
  "meldescheine": [
    {
      "id": 396,
      //.....
      "personen": [
        {
          "id":3334,
          "tarif_id": 1,

          "Gast_Vorname": "Max",
          "Gast_Name": "Mustermann",
          "arrival_date": "2019-01-01",
          "departure_date": "2019-01-15"
        }
      ]
    }
  ]
}
```

<div id="bkmrk-json-%7B-%22meta%22%3A-%7B-%22re"></div><div id="bkmrk--1"></div><div id="bkmrk--2"></div>## Beispiel-Buchungen

Beispiele für verschiedene Szenarien

### Personen-Meldeschein

Folgende Beispiele zeigen jeweils die Buchung eines Scheins. Da die Rückantwort des Servers ist unabhängig des Typs immer gleich.

Request:

<div id="bkmrk-json-1"><label for="__tab_2_0">JSON</label><div>  
</div></div><div id="bkmrk--3"></div><div id="bkmrk-%7B-%22meta%22%3A-%7B-%22vermiet"><div><table class="codehilitetable"><tbody><tr><td class="code">```json
{
  "meta": {
    "vermieter": 1,
    "gemeinde": 1,
    "objekt": 1
  },
  "meldescheine": [
    {
      "input_id": "test-1",
      "personen": [
        {
          "gast_type": "person",
          "tarif_id": 1,
          "Gast_Vorname": "TEST_BF",
          "arrival_date": "2019-07-14",
          "departure_date": "2019-07-17"
        }
      ]
    }
  ]
}

```

</td></tr></tbody></table>

</div><label for="__tab_2_1">XML</label></div>### Gruppen-Meldeschein

Request:

<div id="bkmrk-json-0"><label for="__tab_3_0">JSON</label><div>  
</div></div><div id="bkmrk--4"></div><div id="bkmrk-%7B-%22meta%22%3A-%7B-%22vermiet-0"><div><table class="codehilitetable"><tbody><tr><td class="code">```json
{
  "meta": {
    "vermieter": 1,
    "gemeinde": 1,
    "objekt": 1
  },
  "meldescheine": [
    {
      "input_id": "test-1",
      "personen": [
        {
          "gast_type": "gruppe",
          "anzahl": 5,
          "tarif_id": 1,
          "arrival_date": "2019-07-14",
          "departure_date": "2019-07-17"
        }
      ]
    }
  ]
}

```

</td></tr></tbody></table>

</div><label for="__tab_3_1">XML</label></div>## Code-Beispiele

Folgendes Beispiel authentifiziert die Anfrage und bucht einen Meldeschein

<div id="bkmrk-python-3"><label for="__tab_4_0">Python 3</label><div>  
</div></div><div id="bkmrk--5"></div>```python
# This example uses the "requests" library for HTTP requests (https://requests.readthedocs.io/en/latest/)
# You can install it via 
# $ pip3 install requests
import requests
payload = {
    'username':'api_demo',
    'password':'demodemo',
}

r = requests.post('https://apiv2.meldescheine.de/api/token/',data=payload)
server_response_json = r.json()


jwt_token = server_response_json.get('token') # Aus dem server_response objekt den String-Wert aus "token" extrahieren

# Jetzt buchen
meldeschein_data = {} # Leer für Test
headers = {
 'Authorization':  "JWT %s" % jwt_token
}
r = requests.post("https://apiv2.meldescheine.de/api/import/meldeschein/buchen/",data=meldeschein_data,headers=headers)

```