Schnittstellen, API & Automationen › Zulassungsschein & Scan-Postfach (API)
Zulassungsschein & Scan-Postfach (API)
API-GruppeLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)Nimmt gescannte Zulassungsscheine und Lieferschein/Rechnungs-E-Mails entgegen, lässt die KI Kennzeichen und Fahrzeugdaten auslesen und legt sie dem Büro zur Bestätigung vor.
Bild folgt
Ein Dokument geht über einen von drei Wegen ein: den Kartenleser am Büro-PC über einen eigenen Übertragungsweg mit geheimem Schlüssel (ohne ihn verweigert der Server den Empfang komplett), einen direkten Foto-Upload im Büro-Panel, oder eine E-Mail ans Scan-Eingang. In jedem Fall liefert die Bild-KI nur einen Vorschlag — Kennzeichen, Fahrgestellnummer, Belegtyp, Kopfdaten. Persistiert wird nichts, bevor das Büro den Vorschlag bestätigt hat. Belege ohne erkannten Fahrzeugbezug (Lieferscheine, Eingangsrechnungen, Retouren) landen zunächst als Entwurf im Scan-Eingang und werden erst beim Bestätigen in die jeweilige Fachtabelle übernommen; Beträge auf Finanzbelegen sieht dabei nur, wer eine Finanzberechtigung hat, Eingangsrechnungen und Lieferscheine zusätzlich nur mit entsperrtem Vault. Ein bestätigter Zulassungsschein wird direkt zur Fahrzeugannahme übergeben — dieser Weg funktioniert identisch, egal ob der Schein per Foto im Büro oder per Mail-Anhang ankam. Alte, nicht übernommene Scans räumt ein nächtlicher Lauf automatisch weg (Zulassungsschein-Aufräumung (Cron)).
- Kartenleser-Übertragung meldet „webhook_not_configured" → der geheime Schlüssel für den Kartenleser fehlt auf dem Server; über Foto/Scan im Büro-Panel weiterarbeiten.
- Ein Beleg im Scan-Eingang zeigt keine Beträge → die angemeldete Person hat keine Finanzberechtigung, das ist beabsichtigt.
- Lieferschein oder Eingangsrechnung lässt sich im Scan-Eingang nicht bestätigen → der Vault ist gesperrt, erst mit dem Master-PIN entsperren.
Nutzt
Speist
Gespeist von
- app/api/zulassungsschein-scan
- app/api/admin/scan-inbox
- app/api/admin/zulassungsschein
- app/api/admin/import
- MEM:scan-postfach-live-und-mail-protokoll-2026-08-29.md
- MEM:zulassungsschein-kartenform.md
| aufrufer | Browser-Admin, Kartenleser-Dienst (evrc-agent), Scan-Postfach-Poller |
|---|---|
| routen | 13 (zulassungsschein 5 + scan-inbox 3 + import 4 + zulassungsschein-scan 1) |
| auth | Admin-Login für die Büro-Routen (Scan-Postfach zusätzlich mit Berechtigung "Kunden/Fahrzeuge bearbeiten", Finanzbelege zusätzlich mit Finanzberechtigung, Eingangsrechnungen/Lieferscheine zusätzlich mit entsperrtem Vault); zulassungsschein-scan/ nimmt stattdessen einen eigenen geheimen Schlüssel vom Kartenleser-Dienst entgegen und verweigert ohne diesen fail-closed |
Beleg: MEM:scan-postfach-live-und-mail-protokoll-2026-08-29.md — rechnung@/lieferschein@ Aliase auf scan@; app/api/zulassungsschein-scan, app/api/admin/scan-inbox (3), app/api/admin/zulassungsschein (5)
Tiefer fragen
Kontext aus dem KFZ-Bozo-Handbuch
Knoten: api-zulassungsschein-scan (API-Gruppe · Schnittstellen, API & Automationen · live · geprüft Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit) @ 0f0406a1)
Kurz: Nimmt gescannte Zulassungsscheine und Lieferschein/Rechnungs-E-Mails entgegen, lässt die KI Kennzeichen und Fahrzeugdaten auslesen und legt sie dem Büro zur Bestätigung vor.
Lies zuerst (Lesebereich, nicht der ganze Baum):
app/api/zulassungsschein-scan
app/api/admin/scan-inbox
app/api/admin/zulassungsschein
app/api/admin/import
MEM:scan-postfach-live-und-mail-protokoll-2026-08-29.md (Gedächtnisdatei außerhalb des Repos)
MEM:zulassungsschein-kartenform.md (Gedächtnisdatei außerhalb des Repos)
Hängt zusammen mit:
feat-scan-eingang (app/admin/scan-eingang/page.tsx) · int-llm (lib/ai/provider.ts) · data-belege (lib/db/schema.ts) · auto-scan-mailbox (app/api/cron/scan-mailbox/route.ts)
Offene Fragen der Seite:
keine
Hausregel 2: Vault-Daten sind für diese Session unsichtbar; Quellpfade auf Vault-Code sind keine Freigabe.
Frage: {{DEINE FRAGE}}
Antworte nur mit Belegen: nenne Datei und Zeile für jede Aussage.
Wenn die Quellen die Frage nicht beantworten, sag das und nenne, was du zusätzlich lesen müsstest.
Weicht die Seite vom Code ab, schlage den Seiten-Patch vor (wiki/seiten/schnittstellen-automation/api-zulassungsschein-scan.md).