Zum Inhalt springen

KI-Agenten

Buchungsentwurf

Ein Assistent, der HTTP-Anfragen senden kann, schickt die Auswahl des Gastes an den Betrieb und bekommt einen Link zurück. Der Gast öffnet ihn, sieht eine befüllte Kasse, prüft, stimmt den Bedingungen zu und zahlt selbst.

Hier entsteht keine Buchung und keine Zahlung. Die Zustimmung zu den Bedingungen nimmt der Entwurf gar nicht erst an: die gibt nur ein Mensch.

POST https://skiverleih-talstation.example/api/agent/drafts
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/api/agent/drafts" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"kind": "rental",
"id": "p1",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Martin",
"lastName": "Berger",
"age": 41,
"heightCm": 182,
"weightKg": 84,
"shoeSize": "44",
"skierType": "II"
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
}
],
"poles": true,
"damageWaiver": false
},
{
"kind": "rental",
"id": "p2",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Julia",
"lastName": "Berger",
"age": 38,
"heightCm": 168,
"weightKg": 62,
"shoeSize": "38.5",
"skierType": "II"
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
}
],
"poles": true,
"damageWaiver": false
},
{
"kind": "rental",
"id": "p3",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Leon",
"lastName": "Berger",
"age": 11,
"heightCm": 146,
"weightKg": 38,
"shoeSize": "36",
"skierType": "I",
"headSize": "54"
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
},
{
"categoryCode": "helmet",
"modelCode": "helmet"
}
],
"poles": false,
"damageWaiver": false
}
],
"locale": "de",
"customer": {
"firstName": "Martin",
"lastName": "Berger",
"email": "martin.berger@example.org",
"country": "de"
},
"stay": {
"accommodationId": 2,
"arrivalOn": "2026-12-27",
"departureOn": "2027-01-01"
}
}'

Antwort201Created

Antwort anzeigen 132 Zeilen
{
"draftId": "LXLJzxJzbrHmw7aIKtGIOg",
"url": "https://skiverleih-talstation.example/kasse?draft=LXLJzxJzbrHmw7aIKtGIOg",
"expiresAt": "2026-11-15T18:03:04.778Z",
"totals": {
"items": [
{
"itemId": "p1",
"kind": "rental",
"title": "Martin Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 11400,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 4500,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amountCents": 0,
"lineKind": "poles",
"categoryCode": "poles",
"modelCode": "poles",
"ageBand": "adult"
}
],
"totalCents": 15900,
"depositCents": 0
},
{
"itemId": "p2",
"kind": "rental",
"title": "Julia Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 11400,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 4500,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amountCents": 0,
"lineKind": "poles",
"categoryCode": "poles",
"modelCode": "poles",
"ageBand": "adult"
}
],
"totalCents": 15900,
"depositCents": 0
},
{
"itemId": "p3",
"kind": "rental",
"title": "Leon Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 5200,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "youth"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 2000,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "youth"
},
{
"label": "Helm",
"detail": "6 Tage · Kinder bis 12 gratis",
"amountCents": 0,
"lineKind": "equipment",
"categoryCode": "helmet",
"modelCode": "helmet",
"ageBand": "youth"
}
],
"totalCents": 7200,
"depositCents": 0
}
],
"totalCents": 39000,
"depositCents": 0,
"brokeredCents": 0,
"vatCents": 6500,
"vatPercent": 20,
"articleCents": 0,
"articleVatCents": 0,
"familyHint": null,
"payableCents": 39000,
"currency": "EUR",
"discounts": [],
"delivery": null
}
}
Feld der Antwort Bedeutung
draftId Kennung des Entwurfs, 22 Zeichen
url Link zur befüllten Kasse, in der Sprache aus locale. Diesen Link bekommt der Gast.
expiresAt Bis wann der Entwurf gilt: 24 Stunden ab dem Anlegen
totals Die gerechnete Summe, damit der Assistent den Betrag nennen kann

Gerechnet wird beim Anlegen. Die Kasse rechnet beim Bezahlen neu, wie immer; kein Betrag aus der Anfrage wird übernommen.

Pflicht ist nur items. Alles andere füllt der Gast an der Kasse, wenn es fehlt.

FeldTypBedeutung
itemsPflichtobject[]Positionen. Der Server rechnet den Preis aus ihnen; Beträge im Rumpf werden verworfen.mind. 1 · max. 50 Einträge
items[].kindPflicht"rental"Art der Position. Für diesen Endpunkt rental.
items[].idstringEigene Kennung der Position. Geben Sie jeder Position eine andere, etwa p1, p2.max. 40 Zeichen
items[].fromPflichtstringErster Miettag dieser Person.JJJJ-MM-TT
items[].daysPflichtintegerAnzahl der Miettage.1 bis 60
items[].personPflichtobjectDie Person, die die Ausrüstung trägt.
items[].person.firstNamestringVorname.max. 60 Zeichen · Vorgabe ``
items[].person.lastNamestringNachname.max. 60 Zeichen · Vorgabe ``
items[].person.ageinteger | nullAlter in Jahren. Bestimmt das Preisband und den Gratishelm für Kinder.1 bis 110
items[].person.ageGroupstring | nullAltersgruppe statt des Alters, wo der Betrieb nur sie abfragt. Mit einer Zahl in age rechnet der Server mit der Zahl.Erlaubt: child, youth, adult, senior
items[].person.heightCminteger | nullKörpergröße in Zentimetern. Grundlage der Bindungseinstellung.60 bis 230
items[].person.weightKginteger | nullGewicht in Kilogramm. Grundlage der Bindungseinstellung.10 bis 250
items[].person.shoeSizestring | nullSchuhgröße (EU).max. 10 Zeichen
items[].person.headSizestring | nullKopfumfang oder Helmgröße.max. 10 Zeichen
items[].person.skierTypestring | nullFahrertyp nach ISO 11088: I vorsichtig, II durchschnittlich, III sportlich.Erlaubt: I, II, III
items[].person.ownBootsbooleantrue, wenn die Person eigene Skischuhe mitbringt.Vorgabe false
items[].person.bootSoleMminteger | nullSohlenlänge der eigenen Schuhe in Millimetern, von der Sohle abgelesen.200 bis 400
items[].person.wideFeetbooleanHinweis für den Monteur: extra breiter Fuß.Vorgabe false
items[].selectionsobject[]Gewählte Modelle, je Kategorie eines.max. 10 Einträge
items[].selections[].categoryCodePflichtstringCode der Kategorie aus dem Katalog, etwa ski.max. 40 Zeichen
items[].selections[].modelCodePflichtstringCode des Modells aus dem Katalog, etwa ski-comfort.max. 40 Zeichen
items[].polesbooleanSkistöcke dazu. Zu Ski sind sie gratis.Vorgabe false
items[].damageWaiverbooleanHaftungsreduktion dazu, ein Prozentsatz vom Mietpreis.Vorgabe false
items[].lateReturnbooleanRückgabe am nächsten Morgen statt am Abend, gegen Gebühr.Vorgabe false
localestringSprache der Buchung und der Mail an den Gast. Ohne Angabe die Standardsprache.max. 5 Zeichen
customerobjectDie buchende Person.
customer.firstNamestringVorname.max. 60 Zeichen
customer.lastNamestringNachname.max. 60 Zeichen
customer.emailstringE-Mail-Adresse. An sie geht die Bestätigung.max. 160 Zeichen
customer.phonestringTelefonnummer.max. 40 Zeichen
customer.streetstringStraße und Hausnummer der Wohnadresse.max. 120 Zeichen
customer.zipstringPostleitzahl der Wohnadresse.max. 12 Zeichen
customer.citystringOrt der Wohnadresse.max. 80 Zeichen
customer.countrystringLand der Wohnadresse, ISO 3166-1 alpha-2.max. 60 Zeichen
customer.notestringAnmerkung des Gastes.max. 800 Zeichen
stayobjectAufenthalt und Lieferadresse.
stay.accommodationIdinteger | nullNummer aus der Liste der Unterkünfte. Die Lieferadresse kommt immer aus dieser Liste.ab 1
stay.pickupAtDepotbooleantrue: Abholung im Shop, keine Lieferung.
stay.arrivalOnstringAnreisetag.JJJJ-MM-TT
stay.departureOnstringAbreisetag.JJJJ-MM-TT
stay.roomsstring[]Zimmernummern, falls bekannt.max. 12 Einträge

Worauf es ankommt:

  • items[].id: Geben Sie jeder Position eine eigene Kennung.
  • selections nimmt Codes aus dem Katalog des Betriebs.
  • stay.accommodationId ist eine Nummer aus der Liste der Unterkünfte. Eine Nummer, die es nicht gibt, fällt still weg; der Gast wählt die Unterkunft dann an der Kasse.
  • customer.country ist ein Ländercode aus zwei Buchstaben, groß oder klein. Fehlt er, wählt die Kasse das Land nach der Vorwahl der Telefonnummer vor.
  • Unbekannte Felder werden verworfen, nicht abgelehnt.

Was kein Code ist, lehnt der Server mit einem Hinweis ab:

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/api/agent/drafts" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"kind": "rental",
"id": "p1",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Martin",
"lastName": "Berger",
"age": 41,
"heightCm": 182,
"weightKg": 84,
"shoeSize": "44",
"skierType": "II"
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
}
],
"poles": true,
"damageWaiver": false
}
],
"customer": {
"country": "Deutschland"
}
}'

Antwort400Bad Request

{
"error": {
"code": "invalid_request",
"message": "Feld customer.country: \"Deutschland\" ist kein Ländercode aus zwei Buchstaben.",
"status": 400,
"hint": "Einen Code nach ISO 3166-1 alpha-2 schicken oder das Feld weglassen. Die Kasse kennt AT, DE, NL, CH, CZ, SK, IT, SI, SE, DK, BE, FR, GB, HU, LU, PL, XX; jeder andere Code wird XX, anderes Land.",
"documentation_url": "https://skiverleih-talstation.example/api/"
}
}

Der Rumpf ist als JSON Schema beschrieben, mit einem Beispiel und der Form der Antwort unter $defs.response. Das Schema entsteht bei jedem Abruf aus denselben Regeln, die der Endpunkt prüft.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/agent/drafts/schema"

Antwort200OK

Content-Type
application/schema+json; charset=utf-8
Cache-Control
public, max-age=3600
Antwort anzeigen 619 Zeilen
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://skiverleih-talstation.example/api/agent/drafts/schema",
"title": "Rumpf von POST /api/agent/drafts",
"description": "JSON-Rumpf für https://skiverleih-talstation.example/api/agent/drafts (Content-Type: application/json). Legt einen Entwurf an und antwortet mit einem Link zur befüllten Kasse, 24 Stunden gültig; die Form der Antwort steht unter $defs.response. Pflicht ist nur items. Beträge werden nie angenommen, der Server rechnet; unbekannte Felder werden verworfen, nicht abgelehnt. Modellcodes aus https://skiverleih-talstation.example/api/public/catalog, die Unterkunft als Nummer aus https://skiverleih-talstation.example/api/public/accommodations. Die Zustimmung zu den Bedingungen gibt nur der Mensch an der Kasse.",
"type": "object",
"properties": {
"items": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "rental"
},
"id": {
"type": "string",
"maxLength": 40
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 60
},
"person": {
"type": "object",
"properties": {
"firstName": {
"default": "",
"type": "string",
"maxLength": 60
},
"lastName": {
"default": "",
"type": "string",
"maxLength": 60
},
"age": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 110
},
{
"type": "null"
}
]
},
"ageGroup": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"child",
"youth",
"adult",
"senior"
]
},
{
"type": "null"
}
]
},
"heightCm": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 60,
"maximum": 230
},
{
"type": "null"
}
]
},
"weightKg": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 10,
"maximum": 250
},
{
"type": "null"
}
]
},
"shoeSize": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"headSize": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"skierType": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"I",
"II",
"III"
]
},
{
"type": "null"
}
]
},
"ownBoots": {
"default": false,
"type": "boolean"
},
"bootSoleMm": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 200,
"maximum": 400
},
{
"type": "null"
}
]
},
"wideFeet": {
"default": false,
"type": "boolean"
}
}
},
"selections": {
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"categoryCode": {
"type": "string",
"maxLength": 40
},
"modelCode": {
"type": "string",
"maxLength": 40
}
},
"required": [
"categoryCode",
"modelCode"
]
}
},
"poles": {
"default": false,
"type": "boolean"
},
"damageWaiver": {
"default": false,
"type": "boolean"
},
"lateReturn": {
"default": false,
"type": "boolean"
}
},
"required": [
"kind",
"from",
"days",
"person"
]
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "course"
},
"id": {
"type": "string",
"maxLength": 40
},
"courseId": {
"type": "string",
"maxLength": 20
},
"courseName": {
"default": "",
"type": "string",
"maxLength": 120
},
"variantId": {
"type": "string",
"maxLength": 20
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"persons": {
"default": [],
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"firstName": {
"default": "",
"type": "string",
"maxLength": 60
},
"lastName": {
"default": "",
"type": "string",
"maxLength": 60
},
"age": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 110
},
{
"type": "null"
}
]
},
"ageGroup": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"child",
"youth",
"adult",
"senior"
]
},
{
"type": "null"
}
]
},
"heightCm": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 60,
"maximum": 230
},
{
"type": "null"
}
]
},
"weightKg": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 10,
"maximum": 250
},
{
"type": "null"
}
]
},
"shoeSize": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"headSize": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"skierType": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"I",
"II",
"III"
]
},
{
"type": "null"
}
]
},
"ownBoots": {
"default": false,
"type": "boolean"
},
"bootSoleMm": {
"default": null,
"anyOf": [
{
"type": "integer",
"minimum": 200,
"maximum": 400
},
{
"type": "null"
}
]
},
"wideFeet": {
"default": false,
"type": "boolean"
}
}
}
},
"skillId": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"meetingPointId": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 10
},
{
"type": "null"
}
]
},
"language": {
"default": "de",
"type": "string",
"maxLength": 5
}
},
"required": [
"kind",
"courseId",
"variantId",
"date"
]
}
]
}
},
"locale": {
"type": "string",
"maxLength": 5
},
"customer": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"maxLength": 60
},
"lastName": {
"type": "string",
"maxLength": 60
},
"email": {
"type": "string",
"maxLength": 160
},
"phone": {
"type": "string",
"maxLength": 40
},
"street": {
"type": "string",
"maxLength": 120
},
"zip": {
"type": "string",
"maxLength": 12
},
"city": {
"type": "string",
"maxLength": 80
},
"country": {
"description": "Land der buchenden Person nach ISO 3166-1 alpha-2, groß oder klein geschrieben. Die Kasse kennt AT, DE, NL, CH, CZ, SK, IT, SI, SE, DK, BE, FR, GB, HU, LU, PL, XX; ein anderer Code aus zwei Buchstaben wird XX, anderes Land. Fehlt es, wählt die Kasse das Land nach der Vorwahl der Telefonnummer vor.",
"type": "string",
"maxLength": 60
},
"note": {
"type": "string",
"maxLength": 800
}
}
},
"stay": {
"type": "object",
"properties": {
"accommodationId": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"pickupAtDepot": {
"type": "boolean"
},
"arrivalOn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"departureOn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"rooms": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"maxLength": 20
}
}
}
}
},
"required": [
"items"
],
"examples": [
{
"items": [
{
"kind": "rental",
"from": "2026-12-05",
"days": 6,
"person": {
"firstName": "Anna",
"lastName": "Muster",
"age": 35,
"heightCm": 168,
"weightKg": 62,
"shoeSize": "38",
"skierType": "II"
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
},
{
"categoryCode": "helmet",
"modelCode": "helmet"
}
],
"poles": true,
"damageWaiver": true
}
],
"locale": "de",
"customer": {
"firstName": "Anna",
"lastName": "Muster",
"email": "anna.muster@example.com",
"phone": "+43 664 1234567",
"country": "AT"
},
"stay": {
"accommodationId": 4,
"arrivalOn": "2026-12-05",
"departureOn": "2026-12-11"
}
}
],
"$defs": {
"response": {
"description": "Antwort 201 auf POST /api/agent/drafts. Den Link in url dem Menschen geben: er prüft, stimmt den Bedingungen zu und zahlt selbst. Es entsteht keine Buchung und keine Zahlung.",
"type": "object",
"required": [
"draftId",
"url",
"expiresAt",
"totals"
],
"properties": {
"draftId": {
"type": "string",
"description": "Kennung des Entwurfs, 22 Zeichen."
},
"url": {
"type": "string",
"format": "uri",
"description": "Link zur befüllten Kasse, in der Sprache aus locale."
},
"expiresAt": {
"type": "string",
"format": "date-time",
"description": "Gültig bis, 24 Stunden nach dem Anlegen."
},
"totals": {
"type": "object",
"description": "Der auf dem Server gerechnete Warenkorb, Beträge in Cent. Die Kasse rechnet beim Bezahlen neu.",
"required": [
"items",
"totalCents",
"depositCents",
"payableCents",
"currency",
"discounts"
],
"properties": {
"items": {
"type": "array",
"description": "Je Position Titel, Zeilen und Summe."
},
"totalCents": {
"type": "integer",
"description": "Warenwert ohne Kaution, nach Rabatten."
},
"depositCents": {
"type": "integer",
"description": "Kaution, wird nach der Rückgabe erstattet."
},
"payableCents": {
"type": "integer",
"description": "Zu zahlen: totalCents plus depositCents."
},
"currency": {
"type": "string"
},
"discounts": {
"type": "array"
},
"delivery": {
"type": [
"object",
"null"
],
"description": "Lieferung nach Zone der Unterkunft; fehlt ohne Unterkunft."
}
}
}
}
}
}
}
Terminal-Fenster
curl "https://skiverleih-talstation.example/api/agent/drafts/LXLJzxJzbrHmw7aIKtGIOg"

Antwort200OK

Antwort anzeigen 247 Zeilen
{
"items": [
{
"kind": "rental",
"id": "p1",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Martin",
"lastName": "Berger",
"age": 41,
"ageGroup": null,
"heightCm": 182,
"weightKg": 84,
"shoeSize": "44",
"headSize": null,
"skierType": "II",
"ownBoots": false,
"bootSoleMm": null,
"wideFeet": false
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
}
],
"poles": true,
"damageWaiver": false,
"lateReturn": false
},
{
"kind": "rental",
"id": "p2",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Julia",
"lastName": "Berger",
"age": 38,
"ageGroup": null,
"heightCm": 168,
"weightKg": 62,
"shoeSize": "38.5",
"headSize": null,
"skierType": "II",
"ownBoots": false,
"bootSoleMm": null,
"wideFeet": false
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
}
],
"poles": true,
"damageWaiver": false,
"lateReturn": false
},
{
"kind": "rental",
"id": "p3",
"from": "2026-12-27",
"days": 6,
"person": {
"firstName": "Leon",
"lastName": "Berger",
"age": 11,
"ageGroup": null,
"heightCm": 146,
"weightKg": 38,
"shoeSize": "36",
"headSize": "54",
"skierType": "I",
"ownBoots": false,
"bootSoleMm": null,
"wideFeet": false
},
"selections": [
{
"categoryCode": "ski",
"modelCode": "ski-comfort"
},
{
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort"
},
{
"categoryCode": "helmet",
"modelCode": "helmet"
}
],
"poles": false,
"damageWaiver": false,
"lateReturn": false
}
],
"locale": "de",
"customer": {
"firstName": "Martin",
"lastName": "Berger",
"email": "martin.berger@example.org",
"country": "DE"
},
"stay": {
"accommodationId": 2,
"arrivalOn": "2026-12-27",
"departureOn": "2027-01-01"
},
"expiresAt": "2026-11-15T18:03:04.778Z",
"totals": {
"items": [
{
"itemId": "p1",
"kind": "rental",
"title": "Martin Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 11400,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 4500,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amountCents": 0,
"lineKind": "poles",
"categoryCode": "poles",
"modelCode": "poles",
"ageBand": "adult"
}
],
"totalCents": 15900,
"depositCents": 0
},
{
"itemId": "p2",
"kind": "rental",
"title": "Julia Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 11400,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 4500,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amountCents": 0,
"lineKind": "poles",
"categoryCode": "poles",
"modelCode": "poles",
"ageBand": "adult"
}
],
"totalCents": 15900,
"depositCents": 0
},
{
"itemId": "p3",
"kind": "rental",
"title": "Leon Berger",
"subtitle": "Verleih · ab 27.12.2026 · 6 Tage",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amountCents": 5200,
"lineKind": "equipment",
"categoryCode": "ski",
"modelCode": "ski-comfort",
"ageBand": "youth"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amountCents": 2000,
"lineKind": "equipment",
"categoryCode": "skiboots",
"modelCode": "skiboots-comfort",
"ageBand": "youth"
},
{
"label": "Helm",
"detail": "6 Tage · Kinder bis 12 gratis",
"amountCents": 0,
"lineKind": "equipment",
"categoryCode": "helmet",
"modelCode": "helmet",
"ageBand": "youth"
}
],
"totalCents": 7200,
"depositCents": 0
}
],
"totalCents": 39000,
"depositCents": 0,
"brokeredCents": 0,
"vatCents": 6500,
"vatPercent": 20,
"articleCents": 0,
"articleVatCents": 0,
"familyHint": null,
"payableCents": 39000,
"currency": "EUR",
"discounts": [],
"delivery": null
}
}

Die Kasse liest den Entwurf auf diesem Weg. Die Summe in totals ist neu gerechnet: seit dem Anlegen kann sich eine Preisliste geändert haben.

Nach 24 Stunden, oder nachdem der Gast gebucht hat, gibt es den Entwurf nicht mehr:

Antwort404Not Found

{
"error": {
"code": "not_found",
"message": "Diesen Entwurf gibt es nicht mehr.",
"status": 404,
"hint": "Entwürfe gelten 24 Stunden. Die Auswahl auf der Seite neu zusammenstellen.",
"documentation_url": "https://skiverleih-talstation.example/api/"
}
}

Öffnet der Gast den Link, füllt die Kasse Warenkorb, Aufenthalt und Kontaktdaten vor. Oben steht ein Hinweis, dass ein KI-Assistent die Kasse vorbereitet hat und der Gast alle Angaben prüfen soll.

Bucht der Gast, trägt die Buchung die Herkunft agent, und der Entwurf wird mit der Buchung gelöscht. Im Portal steht an der Buchung: Vorbereitet von einem KI-Assistenten.

Je Adresse gehen 30 Entwürfe in der Stunde. Das Werkzeug create_cart_link des MCP-Servers zählt in denselben Topf: ein Entwurf ist ein Entwurf, gleich auf welchem Weg er kommt.