Schnittstellen, API & Automationen › Aufträge & Werkstatt-Ablauf (API)
Aufträge & Werkstatt-Ablauf (API)
API-GruppeLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)Das API-Rückgrat der Auftragsverwaltung: Aufträge anlegen, Status ändern, Prüfpunkte, Messungen, Reklamationen und Beanstandungen speichern. Mit Abstand die größte Gruppe der Website — allein 'admin/jobs' hat 80 eigene Routen.
Bild folgt
Diese Gruppe trägt den kompletten Auftrags-Lebenszyklus: Status wechseln, Bühne zuweisen, Prüfpunkte und Messungen erfassen, Fotos anhängen, Reklamationen und Beanstandungen festhalten, bis hin zu Angebot, Rechnung und Mahnung je Auftrag. Ein Auftrag erreicht den Status „abgerechnet" nur, wenn vorher tatsächlich eine Rechnungsnummer vergeben wurde — ein früherer Fehler, der das übersprang, ist inzwischen behoben. Normales Löschen verschiebt einen Auftrag zuerst nur in den Vault (Archiv); das wirklich spurlose Endlöschen ist eine eigene, viel strenger geschützte letzte Stufe, die nur der Inhaber mit entsperrtem Vault und einem festen Bestätigungswort auslösen kann, und die abgerechnete Aufträge wegen der siebenjährigen Aufbewahrungsfrist ohnehin blockiert.
- Auftrag lässt sich nicht abrechnen → ohne gültige, bereits vergebene Rechnungsnummer verweigert das System den Wechsel auf „abgerechnet".
- Auftrag verschwindet aus der Liste → er wurde in den Vault verschoben (Archiv), nicht gelöscht; nur der Inhaber kann ihn dort wiederfinden.
- Endgültiges Löschen wird verweigert → betrifft entweder eine bereits bezahlte Rechnung (gesetzliche Aufbewahrungsfrist) oder das Bestätigungswort fehlt bzw. ist falsch geschrieben.
- Enthaelt 'admin/jobs' auch die vaultsensiblen Einzelabruf-Routen aus dem 2026-08-30 Vault-Leck-Fix vollstaendig gefiltert? (laut MEM: gefixt, aber nicht Zeile-fuer-Zeile neu verifiziert)
- app/api/admin/jobs
- app/api/admin/auftrag
- app/api/admin/checks
- app/api/admin/messung
- app/api/admin/protokoll
- app/api/admin/complaints
- app/api/admin/reifen
| aufrufer | Browser-Admin |
|---|---|
| routen | ~110 (jobs 80 + auftrag 4 + checks 4 + messung 6 + protokoll 2 + complaints 2 + reifen 2 + weitere) |
| auth | Admin-Session, die meisten schreibenden Routen zusätzlich mit Recht 'edit_jobs' oder 'edit_finance'; endgültiges Löschen zusätzlich nur Inhaber + Vault-Entsperrung + Bestätigungswort |
Beleg: app/api/admin/jobs (80 route.ts), app/api/admin/auftrag (4), app/api/admin/checks (4), app/api/admin/messung (6)
Tiefer fragen
Kontext aus dem KFZ-Bozo-Handbuch
Knoten: api-jobs-auftraege (API-Gruppe · Schnittstellen, API & Automationen · live · geprüft Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit) @ 0f0406a1)
Kurz: Das API-Rückgrat der Auftragsverwaltung: Aufträge anlegen, Status ändern, Prüfpunkte, Messungen, Reklamationen und Beanstandungen speichern. Mit Abstand die größte Gruppe der Website — allein 'admin/jobs' hat 80 eigene Routen.
Lies zuerst (Lesebereich, nicht der ganze Baum):
app/api/admin/jobs
app/api/admin/auftrag
app/api/admin/checks
app/api/admin/messung
app/api/admin/protokoll
app/api/admin/complaints
app/api/admin/reifen
Hängt zusammen mit:
sec-admin-login (lib/admin-auth.ts) · sec-csrf-origin-guard (lib/api-guard.ts) · data-auftrag (lib/db/jobs.ts) · app-admin-crm (app/admin/layout.tsx) · sec-admin-login (lib/admin-auth.ts)
Offene Fragen der Seite:
Enthaelt 'admin/jobs' auch die vaultsensiblen Einzelabruf-Routen aus dem 2026-08-30 Vault-Leck-Fix vollstaendig gefiltert? (laut MEM: gefixt, aber nicht Zeile-fuer-Zeile neu verifiziert)
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-jobs-auftraege.md).