Zum Inhalt springen

KI & Agenten-Integration

fiskaly stellt eine umfassende Sammlung maschinenlesbarer Endpunkte und Tools bereit, die für KI-Agenten, Coding-Assistenten und automatisierte Integrations-Pipelines konzipiert sind. Dieser Abschnitt dokumentiert, wie fiskaly-APIs programmatisch entdeckt, abgefragt und integriert werden können — ohne HTML-Dokumentation zu lesen.

Architektur

Abschnitt betitelt „Architektur“

KI-Agenten interagieren mit fiskaly über ein mehrschichtiges Entdeckungssystem:

┌─────────────────────────────────────────────────┐
│  Discovery Layer                                │
│  llms.txt → CLAUDE.md → ai-plugin.json          │
├─────────────────────────────────────────────────┤
│  Structured Data                                │
│  products.json → regulatory.json                │
│  human-interventions.json                       │
├─────────────────────────────────────────────────┤
│  API Specifications                             │
│  9 OpenAPI specs (JSON/YAML)                    │
├─────────────────────────────────────────────────┤
│  Interactive Tooling                            │
│  MCP Server (search, specs, products, errors)   │
└─────────────────────────────────────────────────┘
  1. Entdeckung — llms.txt und ai-plugin.json informieren Agenten darüber, was fiskaly ist und wo strukturierte Daten zu finden sind.
  2. Strukturierte Daten — products.json liefert maschinenlesbare Produkt-Metadaten mit Basis-URLs, Spec-URLs und Dokumentationslinks.
  3. API-Spezifikationen — 9 OpenAPI-Spezifikationen decken alle Endpunkte aller fiskaly-Produkte ab.
  4. Interaktives Tooling — Der MCP-Server ermöglicht es Agenten, in Echtzeit nach Dokumentation zu suchen, Spezifikationen abzurufen und Fehlercodes nachzuschlagen.

Einstieg als KI-Agent

Abschnitt betitelt „Einstieg als KI-Agent“

  1. Discovery-Index abrufen

    Beginnen Sie mit https://workspace.fiskaly.com/llms.txt für einen Klartext-Index aller Dokumentationen und Spezifikationen, oder mit /CLAUDE.md für einen strukturierten Integrationsleitfaden.

  2. Das richtige Produkt identifizieren

    Fragen Sie https://workspace.fiskaly.com/products.json ab, um das Produkt zu finden, das zu Ihrem Zielland passt. Jeder Eintrag enthält apiArchitecture, baseUrls und specUrl.

  3. Die OpenAPI-Spezifikation laden

    Rufen Sie die Spec-URL aus dem Produkt-Manifest ab (z. B. /specs/sign-de-v2.json), um vollständige Endpunktdefinitionen, Anfrage-/Antwort-Schemas und Authentifizierungsdetails zu erhalten.

  4. Auf menschlich erforderliche Schritte prüfen

    Fragen Sie /human-interventions.json ab, um zu ermitteln, welche Schritte einen Menschen erfordern (Kontoerstellung, API-Schlüssel, Go-live) und welche vollständig automatisierbar sind.

Was dieser Abschnitt enthält

Abschnitt betitelt „Was dieser Abschnitt enthält“

MCP-Server

Richten Sie den fiskaly-docs-MCP-Server in Claude Code, Cursor oder einem beliebigen MCP-Client ein und verwenden Sie ihn.

Maschinenlesbare Endpunkte

Alle Entdeckungs- und Daten-Endpunkte mit URLs, Formaten und Nutzungsbeispielen.

Best Practices für Agenten

Empfohlener Integrationsablauf, häufige Anti-Muster und länderspezifische Besonderheiten.

Menschliche Interventionen

Welche Aktionen automatisierbar sind und welche einen Menschen erfordern.

Was this page helpful?