# Buchungskalender: API-Vertrag

Verbindlich für Strang 2 (Widget und Buchungsseite, bauen gegen die öffentliche Schnittstelle) und Strang 3 (Portal, baut gegen die Kunden-API). Task 6 bis 8 erfüllen ihn. Fehlerform überall `{ fehler: code, felder?: {feld: text} }`.

## Öffentlich (`/api/public/unterkunft/v1`)

- `GET /:siteKey` → `{ aktiv:true, anbieter:{ name, ort, datenschutzUrl }, akzentfarbe, formToken, unterkuenfte:[{ id, name, maxPersonen, mindestNaechte, checkIn, checkOut }] }` oder `{ aktiv:false }`.
- `GET /:siteKey/belegung?unterkunft=<id>&von=YYYY-MM-DD&bis=YYYY-MM-DD` → `{ belegt:[{von,bis}], heute:'YYYY-MM-DD', bisMax:'YYYY-MM-DD' }` (Quellen nicht offengelegt).
- `POST /:siteKey/anfrage` Body `{ unterkunft, von, bis, personen, name, firma, email, telefon, nachricht, formToken, kontakt_url }` → `201 { nummer }`.
- `GET /:siteKey/buchung/:id?t=` → `{ status, nummer, unterkunft:{name,checkIn,checkOut}, von, bis, naechte, personen, posten, summen, steuerart, fristAt, stornobedingungen, anbieter:{firma,inhaber,strasse,plz,ort,email,telefon}, gast:{name,firma}, rechnungsadresse?, zahlarten:['vorort'|'online'], zahlart?, bezahlt:boolean, rechnungNummer? }`.
- `POST /:siteKey/buchung/:id?t=` Body `{ rechnungsadresse:{name,firma,strasse,plz,ort,land}, zahlart }` → `{ status:'gebucht', rechnungNummer, zahlungUrl? }` (bei `online` direkt Checkout-URL).
- `POST /:siteKey/buchung/:id/zahlung?t=` → `{ url }`.
- `GET /:siteKey/buchung/:id/rechnung.pdf?t=&art=rechnung|storno` → PDF.

## Kunde (`/api/unterkunft`, Session, `?projectId=`)

- `GET /status`
- `GET|PUT /einstellungen`
- `GET /unterkuenfte`
- `POST /unterkuenfte`
- `PUT|DELETE /unterkuenfte/:id`
- `GET|PUT /unterkuenfte/:id/preise`
- `GET /unterkuenfte/:id/kalender?von&bis` → `{ bereiche:[{von,bis,quelle,anfrageNummer?,sperreId?,notiz?}] }`
- `POST /unterkuenfte/:id/sperren`
- `DELETE /sperren/:id`
- `POST /unterkuenfte/:id/ical-importe`
- `DELETE /unterkuenfte/:id/ical-importe/:importId`
- `POST /unterkuenfte/:id/ical-export/erneuern`
- `GET /anfragen?filter=offen|gebucht|alle`
- `GET /anfragen/:id` (inkl. `vorschlag` = `berechnePreis`)
- `POST /anfragen/:id/freigeben` `{posten,fristTage,nachricht}`
- `POST /anfragen/:id/ablehnen` `{text}`
- `POST /anfragen/:id/bezahlt`
- `POST /anfragen/:id/stornieren` `{grund, erstattungCent}`
- `POST /preisvorschau` `{unterkunftId,von,bis,personen}`
- `GET /rechnungen`
- `GET /rechnungen/:id.pdf` (nur Einzel-PDF, kein ZIP — Spec N7)
- `POST /stripe/verbinden`, `POST /stripe/vorhandenes-konto`, `POST /stripe/aktualisieren`
- `POST /anfrage-funktion` `{art,einheiten,portale,nachricht}`
- `POST /anfrage-funktion/zurueckziehen`

## Team (`/api/team/unterkunft`)

- `GET /:customerId`
- `POST /:customerId/anfrage` `{projectId, entscheidung, begruendung}`