Die fiskaly Unified API ist eine einheitliche Integrierungsarchitektur, die mehrere Länder abdeckt. Einmal integrieren. Jedes neue Land erfordert nur wenige kleine, länderspezifische Compliance-Anpassungen, keine Neuentwicklung Ihrer Integrierung.
| Land | Produkt | Gruppe |
|---|---|---|
| 🇫🇷 Frankreich | SIGN FR | SIGN |
| 🇮🇹 Italien | SIGN IT | SIGN |
| 🇵🇹 Portugal | SIGN PT | SIGN |
| 🇸🇪 Schweden | SIGN SE | SIGN |
| 🇪🇸 Spanien | SIGN ES Vorschau | SIGN |
| 🇦🇹 Österreich | SIGN AT Vorschau | SIGN |
| 🇧🇪 Belgien | E-INVOICE BE | E-INVOICE |
| 🇩🇪 Deutschland | E-INVOICE DE | E-INVOICE |
| 🇮🇹 Italien | E-INVOICE IT | E-INVOICE |
Länderspezifische Dokumentation
Abschnitt betitelt „Länderspezifische Dokumentation“Die API-Spezifikation passt sich Ihrer Marktauswahl an. Verwenden Sie den Länderauswahl oben auf den Spec-Seiten, um die Märkte auszuwählen, die Sie integrieren — die Dokumentation zeigt dann genau, was für Ihre Auswahl gilt:
- Text ohne Flagge ist die gemeinsame Basis, die für alle ausgewählten Länder gilt.
- Mit einer Länderflagge markierte Blöcke (zum Beispiel 🇮🇹 oder 🇫🇷) enthalten zusätzliche länderspezifische Informationen — zusätzliche Felder, abweichendes Verhalten oder zusätzliche Anforderungen für diesen Markt.
- Die Schaltfläche Download exportiert eine OpenAPI-Datei, die auf Ihre aktuelle Auswahl zugeschnitten ist.
Dieselbe länderspezifische Hinweisführung findet sich in den Guides dieses Abschnitts — jede Ländergruppe in der Seitenleiste behandelt die Besonderheiten ihres Marktes.
Basis-URLs
Abschnitt betitelt „Basis-URLs“| Umgebung | URL |
|---|---|
| Test | test.api.fiskaly.com |
| Live | live.api.fiskaly.com |
Erforderliche Header
Abschnitt betitelt „Erforderliche Header“| Header | Beschreibung |
|---|---|
X-Api-Version | API-Versionsdatum, z. B. 2026-06-01 |
X-Scope-Identifier | Organization-ID |
X-Idempotency-Key | UUIDv4 — erforderlich bei jedem POST und PATCH |
Authorization | Bearer <access_token> |
Versionierung
Abschnitt betitelt „Versionierung“Die Unified API verwendet eine kalenderbasierte Versionierung (YYYY-MM-DD). Die aktuelle Version ist 2026-06-01.
| Version | SIGN | E-INVOICE |
|---|---|---|
2026-06-01 | FR, IT, PT, SE, ES, AT | BE, DE, IT |
2026-05-04 | FR, IT, PT | BE, DE |
2026-02-03 | FR, IT | BE, DE |
Im Vergleich zu Spezialisierten APIs
Abschnitt betitelt „Im Vergleich zu Spezialisierten APIs“| Unified API | Spezialisierte APIs | |
|---|---|---|
| Länder | FR, IT, PT, SE, ES1, AT1, BE2, DE2 | DE, AT, ES |
| Basis-URL | Länderübergreifend gemeinsam | Produktspezifisch |
| Ressourcen-IDs | Server-generiert | Client-generierte UUIDs |
| Org-Verwaltung | In die API integriert | Separate Management API |
| Ein Land hinzufügen | Kleine Schema-Anpassungen | Neue Integrierung erforderlich |
1 über beide APIs verfügbar · 2 nur E-Invoicing
SIGN DE ist eine Spezialisierte API. Die Unified API-Integrierung ist bereits in Arbeit. Die E-Rechnungsstellung für Deutschland ist bereits Teil der Unified API.