Maschinenlesbare Endpunkte

fiskaly veröffentlicht neben der menschenlesbaren Dokumentationsseite eine Reihe maschinenlesbarer Endpunkte. Diese Endpunkte sind für KI-Agenten, LLM-Crawler und Automatisierungs-Pipelines konzipiert, die strukturierten Zugriff auf Produkt-Metadaten, API-Spezifikationen und regulatorische Daten benötigen.

Endpunkt-Referenz

Endpunkt	Format	Zweck
/llms.txt	Klartext	LLM-Entdeckungsindex — listet alle Dokumentationsseiten und Spec-URLs auf
/llms-full.txt	Klartext	Vollständiger Dokumentations-Dump für LLM-Kontext-Ingestion
/products.json	JSON	Produkt-Manifest mit Metadaten, Basis-URLs und Spec-URLs für alle 14 Produkte
/human-interventions.json	JSON	Register automatisierbarer vs. menschlich erforderlicher Aktionen mit Zusammenfassungen
/regulatory.json	JSON	Länderspezifische regulatorische Anforderungen und Compliance-Details
/.well-known/ai-plugin.json	JSON	KI-Plugin-Manifest (OpenAI-Plugin-Spec-Format)
/CLAUDE.md	Markdown	Agenten-Integrationsleitfaden mit Authentifizierung, Mustern und länderspezifischer Referenz
/specs/sign-de-v2.json	JSON	SIGN DE v2 OpenAPI-Spezifikation
/specs/spec-sign-at.json	JSON	SIGN AT (RKSV) OpenAPI-Spezifikation
/specs/fiskaly.sign-fr.2026-02-03.yaml	YAML	SIGN FR OpenAPI-Spezifikation (Unified API)
/specs/fiskaly.sign-it.2026-02-03.yaml	YAML	SIGN IT OpenAPI-Spezifikation (Unified API)
/specs/fiskaly.e-invoice-be.2026-02-03.yaml	YAML	E-INVOICE BE OpenAPI-Spezifikation (Unified API)
/specs/fiskaly.e-invoice-de.2026-02-03.yaml	YAML	E-INVOICE DE OpenAPI-Spezifikation (Unified API)
/specs/spec-sign-es.yaml	YAML	SIGN ES OpenAPI-Spezifikation
/specs/spec-dsfinvk.json	JSON	DSFinV-K OpenAPI-Spezifikation
/specs/spec-ereceipt.json	JSON	eReceipt OpenAPI-Spezifikation
/specs/spec-merchant.json	JSON	Management API OpenAPI-Spezifikation
/specs/spec-obono.json	JSON	obono (SIGN AT SaaS) OpenAPI-Spezifikation

Alle Endpunkte werden von https://workspace.fiskaly.com bereitgestellt.

Entdeckungsablauf

Ein typischer Agenten-Entdeckungsablauf sieht so aus:

1. /llms.txt abrufen
   → Index aller verfügbaren Dokumentationen und Spezifikationen erhalten

2. /products.json abrufen
   → Das Produkt finden, das zum Zielland passt
   → baseUrls, specUrl und docsUrl extrahieren

3. /specs/{product-spec} abrufen
   → Die vollständige OpenAPI-Spezifikation für das gewählte Produkt laden

4. /human-interventions.json abrufen
   → Identifizieren, welche Schritte automatisierbar vs. menschlich erforderlich sind

products.json

Das Produkt-Manifest ist der primäre strukturierte Daten-Endpunkt. Jeder Produkteintrag enthält:

{
  "id": "sign-de",
  "name": "SIGN DE",
  "description": "German fiscal signing (KassenSichV)",
  "country": "DE",
  "apiArchitecture": "specialized",
  "baseUrls": {
    "test": "https://kassensichv-middleware.fiskaly.com/api/v2",
    "live": "https://kassensichv.fiskaly.com/api/v2"
  },
  "specUrl": "/specs/sign-de-v2.json",
  "docsUrl": "/countries/germany",
  "apiReferenceUrl": "/api/sign-de"
}

Verwenden Sie apiArchitecture, um das Integrationsmuster zu bestimmen:

• specialized — länderspezifische Basis-URL, client-generierte UUIDs, separate Management API
• unified — gemeinsame Basis-URLs, server-generierte IDs, erforderliche Header (X-Api-Version, X-Idempotency-Key, X-Scope-Identifier)
• platform — produktübergreifende Services (DSFinV-K, eReceipt, Management API)

human-interventions.json

Gibt alle Integrationsaktionen nach Automatisierungsgrad kategorisiert zurück:

{
  "summary": {
    "fullyAutomatable": 11,
    "partiallyAutomatable": 2,
    "requiresHuman": 7
  },
  "interventions": [
    {
      "action": "Authenticate (get token)",
      "product": "All",
      "automatable": "yes",
      "reason": "Standard API call",
      "whatToDo": "POST /auth with api_key + api_secret"
    }
  ]
}

Die vollständige menschenlesbare Referenz finden Sie im Human Intervention Registry.

ai-plugin.json

Das KI-Plugin-Manifest folgt dem OpenAI-Plugin-Spezifikationsformat:

{
  "schema_version": "v1",
  "name_for_model": "fiskaly",
  "description_for_model": "fiskaly provides fiscal compliance APIs...",
  "api": {
    "type": "openapi",
    "url": "https://workspace.fiskaly.com/specs/sign-de-v2.json"
  }
}

Crawler-Zugriff

Die robots.txt-Konfiguration erlaubt LLM-Crawlern den Zugriff auf alle Dokumentations- und maschinenlesbare Endpunkte. Standard-Webcrawler sind für Dokumentationsseiten, Spec-Dateien und strukturierte Daten-Endpunkte zugelassen.

💡Tip

Bevorzugen Sie den MCP-Server gegenüber rohem HTTP-Abruf, wenn Sie in Claude Code oder Cursor arbeiten. Der MCP-Server stellt dieselben Daten über strukturierte Tool-Aufrufe mit eingebautem Suchen und Filtern bereit. Lesen Sie den MCP-Server-Leitfaden.