P
PCA Portal · Verwaltung
Für Betreiber und die PCA-Verwaltung
Die App ist noch nicht eingerichtet — bitte zuerst das Setup durchlaufen (Setup-Token steht in der Server-Konsole).
Studio-Zugänge (z. B. online65101) melden sich auf der Startseite an.
Als Nachweis dient ein PCA-Haupttoken des Betriebs (Client-ID + Secret). Es wird live gegen die PCA-API geprüft — danach wird das Passwort des Betriebs neu gesetzt, dem dieses Token gehört.
P
PCA Portal
Verwaltung · v?
…
Betrieb 0 Studios
Es ist kein Betrieb ausgewählt. Bitte oben einen Betrieb wählen — oder im Tab Betriebe einen neuen anlegen.
Tageszahlen
Zeitraum: letzte 24 Stunden
Anträge nach Studio & Tarif
Nach Studio (nur Studios dieses Betriebs)
Tarife (Haupttarif, instanzweit)
IBAN-Prüfungen (VoP)
Auffällige Prüfungen
Betriebsdaten
Name, Kontakt und Rechtstexte dieses Betriebs. Studios können eigene AGB-/Datenschutz-Links überschreiben (Tab „Studios“).
Wird u. a. als Kennung bei der Adressprüfung mitgesendet.
Online-Abschlüsse tragen eigene Vertragsbedingungen. Bleibt das Feld leer, gilt die reguläre Adresse.
Wer meine Filialen mitbenutzt
Diese Betriebe dürfen Kunden in — bedienen. Freigegeben hat das die PCA-Verwaltung — abschalten können Sie es selbst: Es sind Ihre Kundendaten, Ihr Widerspruch sticht die Freigabe.
Kunden anderer Betriebe mitbedienen
Freigegebene Betriebe dürfen von — aus bedient werden — Kundensuche, Vertragsänderungen, Anträge. Die Freigabe gilt in eine Richtung: Umgekehrt muss sie beim anderen Betrieb gesetzt werden. Ob PCA den Zugriff technisch zulässt, hängt zusätzlich am Haupttoken; deckt er die fremde Agentur nicht ab, meldet der Container das ausdrücklich als Token- und nicht als Rechtefrage.
System
Funktionen
Feature-Schalter dieses Betriebs.
Was hier nicht abweichend gesetzt ist, erbt die globale Vorgabe der PCA-Verwaltung. Zeilen mit geerbt folgen der Vorgabe, Zeilen mit eigen weichen bewusst ab. Studios können zusätzlich einzeln abweichen.
Feature-Flags
Kiosk-PIN
PIN für den Rückweg Kunden-Modus → Bearbeiter-Modus (leer = kein PIN-Gate)
Log-Aufbewahrung
Antrags-Protokoll wird nach dieser Zeit bereinigt
Tage
Tarifarten
PCA führt in jedem Studio drei Arten von Tarifen. Freigegeben wird nur, was die Bearbeiter auch anbieten sollen — Online-Tarife tragen eigene Vertragsbedingungen und erscheinen im Antrag als getrennte Gruppe. Die AGB dafür stehen im Reiter „Betrieb".
Wizards
Welche Assistenten den Bearbeitern zur Verfügung stehen — und ob eine Kundenunterschrift Pflicht ist.
Studios
Melde-E-Mail empfängt Fallback-PDFs und Nachtrags-Hinweise.
Studios werden nicht von Hand angelegt. Sie stammen aus dem OAuth-Scope der PCA-Haupttokens: sobald ein Haupttoken hinterlegt oder geändert wird, erscheinen genau die Agenturen hier, die PCA für dieses Token freigegeben hat. Fehlt ein Studio, muss PCA es dem Token zuordnen (oder es ist bereits einem anderen Betrieb zugewiesen).
Tarif-Freigaben
Welche Tarife die Bearbeiter im Neuabschluss bzw. beim Tarifwechsel auswählen dürfen.
Studio
—
Zugänge
Eigenes Passwort, Maschinen-Tokens für Automationen und — für die PCA-Verwaltung — die PCA-Haupttokens des Betriebs.
Eigenes Passwort ändern
Gilt für die Kennung, mit der du gerade angemeldet bist (—).
Passwort des Betriebs neu setzen
Setzt das Anmelde-Passwort des oben gewählten Betriebs (—) — ohne Kenntnis des alten Passworts.
PCA-Haupttokens des Betriebs
OAuth-Credentials (client_credentials) für die PCA-API. Secret leer lassen = unverändert behalten. Beim Speichern wird jedes Token live gegen PCA verifiziert; Studios aus dem Token-Scope werden automatisch angelegt.
Maschinen-Tokens
Für automatisierte Abrufe von /api/stats/daily (z. B. n8n-Tagesreport) — als ?token=… oder Authorization: Bearer.
Dieser Token wird nur jetzt einmalig im Klartext angezeigt — bitte sofort kopieren und sicher hinterlegen.
Offene Nachträge
Fallback-Vorgänge (PDF-Weg), die noch manuell im PCA-Portal eingetragen werden müssen.
Erledigt
Betriebe
Alle Mandanten dieser Instanz. Jeder Betrieb hat eigene Zugangsdaten, eigene Studios und eigene Feature-Einstellungen.
Übersicht
KennungNameStudiosHaupttokens
Neuen Betrieb anlegen
Die Studios ergeben sich automatisch aus dem OAuth-Scope der angegebenen Haupttokens — jedes Token wird beim Anlegen live gegen PCA geprüft.
Nur Kleinbuchstaben und Ziffern; damit meldet sich der Betreiber an.
PCA-Haupttokens
Globale Einstellungen
Gelten für die gesamte Instanz — alle Betriebe nutzen dieselben Provider und erben dieselben Vorgaben.
Instanz
Achtung: Das ist dein eigener Login-Name. Nach dem Speichern mit der neuen Kennung anmelden.
Fallback, wenn ein Betrieb keine eigene Kontakt-Adresse hinterlegt hat.
Secure-Cookies
Nur aktivieren, wenn die App über HTTPS erreichbar ist (sonst schlägt der Login fehl).
Daten-Verzeichnis—
Version—
PCA
Die beiden Endpunkte liefert die PCA-Zentrale erst noch. Solange sie leer sind, erzeugen die Wizards „Tarif ändern“ und „Kündigung zurückziehen“ ein Änderungs-PDF, mailen es an Kunde + Studio und legen einen offenen Nachtrag an.
Ausweis-OCR
Key wird verschlüsselt gespeichert. Eine ENV-Variable OCR_API_KEY (data/secrets.env) hat Vorrang.
IBAN-Prüfung (VoP)
Kompletter Header-Wert, z. B. „Bearer xyz…“. ENV-Override: IBAN_AUTH.
Adressprüfung
Mail-Versand
Kontrakt: POST { to, name, pdfBase64, filename, cardId, subject? } → { ok: true }. ENV-Override: MAIL_AUTH. Reine HTML-Mails (Tagesbericht) gehen als { to, subject, html } an denselben Endpoint.
Tagesbericht
Der tägliche Antrags-Bericht (Anträge, Ausweis- und IBAN-Prüfungen je Studio und Bearbeiter) — läuft im Container selbst und geht über den oben konfigurierten Mail-Versand. Änderungen wirken sofort, ohne Neustart.
Bericht aktiv
Versand täglich zur eingestellten Uhrzeit; war der Dienst zur Sendezeit nicht erreichbar, wird nachgeliefert.
Mehrere Adressen mit Komma trennen.
Letzter Versand—
Der Testversand nutzt die GESPEICHERTEN Empfänger und trägt den Betreff-Zusatz [TEST] — erst speichern, dann testen.
Globale Vorgaben (Vorlage für alle Betriebe)
Diese Werte gelten überall dort, wo ein Betrieb nichts Eigenes gesetzt hat — und sind die Startwerte für neu angelegte Betriebe.
Kiosk-PIN
Vorgabe für den Rückweg Kunden-Modus → Bearbeiter-Modus
Log-Aufbewahrung
Vorgabe in Tagen
Tage
Wizards