Check-In

Führen Sie Kunden-Check-Ins per QR-Code, manuellem Code oder Admin-Override durch.

Auf dieser Seite

POST /v1/check-in/qr/:token POST /v1/check-in/code POST /v1/check-in/admin

Check-In Workflow

confirmedchecked_inin_progresscompleted

Optional kann die Geo-Position des Kunden zur Validierung (innerhalb 100m der Werkstatt) genutzt werden.

POST/v1/check-in/qr/:token

Check-In per QR-Code-Token. Der Token wird bei der Buchungserstellung generiert und ist in der Bestätigungs-E-Mail als QR-Code enthalten.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
`token`	uuid	Ja	Check-In-Token der Buchung

Body-Parameter (optional)

Name	Typ	Pflicht	Beschreibung
`latitude`	number	Nein	Breitengrad des Kunden für Geo-Validierung
`longitude`	number	Nein	Längengrad des Kunden für Geo-Validierung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/check-in/qr/abc123 class="token-flag">-def456-ghi789 \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{
    "latitude": 52.5200,
    "longitude": 13.4050
  }'

Response200 OK

{
  "success": true,
  "buchung_id": "b1a2c3d4...",
  "status": "checked_in",
  "methode": "qr_scan",
  "eingecheckt_am": "2025-06-15T08: 55: 00Z"
}

POST/v1/check-in/code

Check-In per manuellem 6-stelligen Code. Der Kunde nennt den Code (z.B. A1B2C3) an der Rezeption.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`code`	string	Ja	6-stelliger Check-In-Code (z.B. A1B2C3)
`latitude`	number	Nein	Breitengrad für Geo-Validierung
`longitude`	number	Nein	Längengrad für Geo-Validierung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/check-in/code \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"code": "A1B2C3"}'

Response200 OK

{
  "success": true,
  "buchung_id": "b1a2c3d4...",
  "status": "checked_in",
  "methode": "manual_code",
  "eingecheckt_am": "2025-06-15T08: 55: 00Z"
}

POST/v1/check-in/admin

Admin-Override Check-In. Ermöglicht das Einchecken ohne QR-Code oder manuellen Code, z.B. bei technischen Problemen.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`buchung_id`	uuid	Ja	ID der einzucheckenden Buchung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/check-in/admin \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"buchung_id": "b1a2c3d4..."}'

Response200 OK

{
  "success": true,
  "buchung_id": "b1a2c3d4...",
  "status": "checked_in",
  "methode": "admin_override",
  "eingecheckt_am": "2025-06-15T08: 55: 00Z"
}