Menschliche Eingriffs-Registrierung

Diese Registrierung dokumentiert jede Integrierungsaktion über alle fiskaly-Produkte hinweg und kategorisiert jede als vollständig automatisierbar, teilweise automatisierbar oder menschlichen Eingriff erfordernd. Verwenden Sie sie, um Ihren Integrierungsworkflow zu planen und zu identifizieren, wo Schritte mit menschlicher Beteiligung erforderlich sind.

12 Aktionen können vollständig über API-Aufrufe ohne menschliche Beteiligung abgeschlossen werden.

2 Aktionen erfordern vom Menschen bereitgestellte Daten, können aber von einem Agenten ausgeführt werden.

8 Aktionen müssen von einem Menschen über das Dashboard oder externe Prozesse durchgeführt werden.

Vollständige Registrierung

Aktion	Produkt	Automatisierbar	Grund	Was zu tun ist
fiskaly-Konto erstellen	Alle	Nein	Erfordert E-Mail-Verifizierung und Nutzungsbedingungen-Akzeptanz	Benutzer muss sich unter hub.fiskaly.com oder dashboard.fiskaly.com registrieren
Organisation erstellen	Alle	Nein	Erfordert authentifizierte Dashboard-Sitzung	Benutzer erstellt über HUB oder Dashboard
API Key generieren	Alle	Nein	Erfordert Dashboard-Sitzung; Secret wird einmal angezeigt	Benutzer generiert im HUB oder Dashboard
Authentifizieren (Token abrufen)	Alle	Ja	Standard-API-Aufruf	POST /auth mit api_key + api_secret
TSS erstellen	SIGN DE	Ja	API-Aufruf	PUT /tss/{uuid}
TSS initialisieren	SIGN DE	Ja	Folge von API-Aufrufen	Admin-PIN setzen → Auth → Zustand INITIALIZED
Client erstellen	SIGN DE	Ja	API-Aufruf	PUT /tss/{id}/client/{uuid}
Transaktion erstellen	SIGN DE	Ja	API-Aufruf	PUT mit ACTIVE dann FINISHED
Organisation UNIT erstellen	SIGN FR, SIGN IT	Ja	API-Aufruf	POST /organizations
Subject API Key erstellen	SIGN FR, SIGN IT	Ja	API-Aufruf	POST /subjects
Steuerpflichtigen-Daten eingeben	SIGN FR, SIGN IT	Teilweise	Benötigt echte Steuer-Zugangsdaten	Mensch stellt Steuer-ID bereit; Agent führt API-Aufruf durch
Ressourcen in Betrieb nehmen	SIGN FR, SIGN IT	Ja	Zustandsänderung	PATCH mit Zustand COMMISSIONED
Standort erstellen	SIGN FR, SIGN IT	Ja	API-Aufruf	POST /locations
System erstellen	SIGN FR, SIGN IT	Ja	API-Aufruf	POST /systems
Datensatz erstellen	SIGN FR, SIGN IT	Ja	Zweistufiger API-Aufruf	Intention → Transaction
Von TEST zu LIVE wechseln	Alle	Nein	Erfordert Vertrag	Vertrieb kontaktieren oder HUB-Go-Live verwenden
Zertifizierung erlangen	Alle	Nein	Regulatorischer Prozess	Über die zuständige Behörde beantragen
Abrechnungsdaten eingeben	Alle	Nein	Sensible Finanzdaten	Benutzer gibt im HUB/Dashboard ein
Benutzerzugriff verwalten	Alle	Nein	Sicherheitssensibel	Admin verwaltet über HUB/Dashboard
ELSTER-Registrierung	SUBMIT DE	Teilweise	Benötigt echte Steuerpflichtigen-Daten	Mensch stellt Steuernummer bereit; Agent ruft API auf

Aufschlüsselung nach Kategorie

Menschlichen Eingriff erfordernde Aktionen

Diese Aktionen umfassen Kontosicherheit, rechtliche Vereinbarungen, Finanzdaten oder regulatorische Prozesse, die nicht an Automatisierung delegiert werden können:

• Kontoerstellung — E-Mail-Verifizierung und Nutzungsbedingungen-Akzeptanz
• Organisationserstellung — erfordert authentifizierte Dashboard-Sitzung
• API Key-Generierung — Secret wird einmal angezeigt, erfordert Dashboard
• Von TEST zu LIVE wechseln — erfordert einen signierten Vertrag mit fiskaly
• Zertifizierung erlangen — regulatorischer Prozess über die zuständige Behörde
• Abrechnungsdaten eingeben — sensible Finanzdaten, über Dashboard eingegeben
• Benutzerzugriff verwalten — sicherheitssensibel, nur Admin über Dashboard

Teilweise automatisierbar

Diese Aktionen benötigen vom Menschen bereitgestellte Daten, aber der API-Aufruf selbst kann automatisiert werden:

• Steuerpflichtigen-Daten eingeben (SIGN FR, SIGN IT) — Mensch stellt Steuer-ID bereit, Agent führt API-Aufruf durch
• ELSTER-Registrierung (SUBMIT DE) — Mensch stellt Steuernummer bereit, Agent ruft API auf

Vollständig automatisierbar

Alle Standard-API-Vorgänge nach der Ersteinrichtung:

• Authentifizierungs-Token-Abruf
• TSS-Lebenszyklus (erstellen, initialisieren, Client, Transaktion) für SIGN DE
• Organisationseinheiten, Subjects, Standorte, Systeme und Datensätze für SIGN FR / SIGN IT
• Ressourcen in Betrieb nehmen über Zustandsänderungen

💡Tip

Für KI-Agenten-Entwickler: Beim Aufbau automatisierter Integrierungen planen Sie für Schritte mit menschlicher Beteiligung am Anfang (Konto-Einrichtung, API Keys) und beim Go-Live (Vertrag, Abrechnung). Der Kern-Integrierungsworkflow zwischen diesen Schritten ist vollständig über API automatisierbar. Gestalten Sie Ihren Agenten so, dass er pausiert und den Benutzer für diese spezifischen Schritte auffordert, dann die Automatisierung fortsetzt.

Maschinenlesbare API

Diese Registrierung ist auch als JSON-Endpunkt für den programmatischen Zugriff verfügbar:

GET /human-interventions.json

Die JSON-Antwort enthält die vollständige Interventionsliste mit Zusammenfassungszählungen, geeignet für KI-Agenten und Automatisierungstools zum Abrufen zur Laufzeit.

📘Note

Für einen vollständigen Guide zum Aufbau KI-gestützter fiskaly-Integrierungen — einschließlich MCP-Server, alle maschinenlesbaren Endpunkte und Agenten-Best-Practices — siehe den Abschnitt KI & Agenten.