Support & Problemmeldung

Etwas funktioniert nicht wie erwartet? Diese Seite hilft Ihnen, das Problem schnell zu lösen. Die meisten Anliegen werden am schnellsten gelöst, wenn die erste Nachricht bereits alles enthält, was wir brauchen. Lesen Sie daher bitte die Checkliste, bevor Sie uns schreiben.

💡Sie haben bereits ein Ticket eröffnet?

Vielen Dank. Antworten Sie auf die Ticket-E-Mail mit den Angaben aus der Checkliste unten. Behalten Sie die Ticketnummer im Betreff, damit Ihre Antwort dem richtigen Fall zugeordnet wird.

Bevor Sie uns kontaktieren

Servicestatus prüfen

Bekannte Störungen und Wartungsfenster werden hier zuerst veröffentlicht. Ist ein Status rot, ist kein Ticket nötig.

Fehlercode nachschlagen

Die meisten API-Fehler sind hier mit Ursache und Lösung dokumentiert. Suche nach Fehlercode oder HTTP-Status.

Produkte entdecken

Jedes Produkt hat eigene Integrationsleitfäden und FAQ. Finden Sie Ihres in der Produktübersicht.

Den richtigen Kanal wählen

Wer gleich beim richtigen Team landet, spart sich eine Schleife.

Ihre Situation	Wohin
API-Fehler, unerwartete Antwort, Integrationsfrage	Developer Support: dev-support@fiskaly.com, siehe unten
Sie betreiben eine Kasse und sehen einen Fehler am Gerät	Ihr Kassenanbieter ist Ihr erster Ansprechpartner. Im Operator Center sehen Sie, wer wofür zuständig ist.
Verträge, Preise oder Vertriebsfragen	sales@fiskaly.com
Rechnungen und Buchhaltung	buchhaltung@fiskaly.com

Problem melden

Senden Sie Ihre Meldung an dev-support@fiskaly.com. Bitte eröffnen Sie ein Ticket pro Problem. Wenn Sie zwei voneinander unabhängige Probleme sehen, senden Sie zwei Meldungen. Gemischte Tickets dauern länger, weil unterschiedliche Entwickler darauf schauen müssen.

Developer Support kontaktieren

Was Ihre Meldung enthalten sollte

1. Beschreiben Sie, was Sie erwartet haben und was passiert ist

   Ein bis zwei Sätze reichen. Fügen Sie die exakte Fehlermeldung bei, falls es eine gibt.

2. Sagen Sie uns, wo und wann

   Umgebung (TEST oder LIVE), API und Version sowie ein Zeitstempel mit Zeitzone. Melden Sie sich möglichst zeitnah: Logs lassen sich leichter zuordnen, wenn das Ereignis frisch ist.

3. Fügen Sie Request und vollständige Response bei

   Geben Sie die Kennung an, mit der wir den Aufruf nachverfolgen können: den X-Trace-Identifier-Header bei der Unified API (SIGN IT, FR, PT, SE, BE, ES, AT, CZ, E-INVOICE) oder die Request-ID aus dem X-Request-ID-Antwortheader bei SIGN DE, DSFinV-K und der Management API. Damit finden wir den Aufruf in Sekunden in unseren Systemen.

4. Nennen Sie die betroffenen Ressourcen-IDs

   Welche IDs relevant sind, hängt vom Produkt ab. Die Tabelle unten hilft.

⚠️Senden Sie niemals Zugangsdaten

Entfernen Sie API-Secrets, Bearer-Tokens und Passwörter aus jedem Request, den Sie beifügen. Wir werden Sie nie danach fragen. Wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde, tauschen Sie ihn zuerst aus und informieren Sie uns dann.

Ressourcen-IDs nach Produkt

Produkt	Anzugebende IDs
Unified API (SIGN IT, FR, PT, SE, ES, AT, CZ and E-INVOICE)	Organization ID, Taxpayer ID, Location ID, System ID, Subject ID, Record ID
SIGN DE (Specialized API)	Organization ID, TSS ID, Client ID, Transaction ID, Export ID
SIGN AT (Specialized API)	Cash Register ID, Receipt ID, Signature Creation Unit ID
SIGN ES (Specialized API)	Signer ID, Client ID, Invoice ID, Export ID
DSFinV-K	Cash Register ID, Closing ID, Export ID
SAFE	File ID, Export ID, Annotation ID
eReceipt	Receipt ID, Static ID, Revision
Management API	Organization ID, User ID, Key ID (niemals das Secret)

Vorlage für Ihre Meldung

Kopieren Sie die Vorlage in Ihre E-Mail und füllen Sie jede zutreffende Zeile aus. Die Vorlage bleibt auf Englisch, weil unser Support-Team jedes Ticket auf Englisch triagiert. Das Problem selbst können Sie gern darunter auf Deutsch beschreiben.

Subject: [PRODUCT] Short description of the problem

Company / Organization:
Environment: TEST | LIVE
API and version:
First occurrence (date, time, timezone):
Frequency: once | intermittent | permanent

What I expected:
What happened instead (exact error message):

Request (method, URL, body without secrets):
Response (full body and status code):
Request ID / X-Trace-Identifier:

Affected resource IDs:

What we did right before the error:

Wenn die Produktion betroffen ist, schreiben Sie das in den Betreff, zum Beispiel [LIVE] Signing fails for all clients. So erkennen wir die Auswirkung auf einen Blick.

Wie es weitergeht

1. Bestätigung

   Sie erhalten per E-Mail eine Ticketnummer. Verwenden Sie sie in allen Rückmeldungen.

2. Triage

   Wir prüfen die Meldung und leiten sie an die zuständige Person weiter.

3. Analyse

   Wir stellen gegebenenfalls Rückfragen. Je vollständiger Ihre erste Nachricht, desto weniger davon.

4. Lösung

   Wir halten Sie im Ticket auf dem Laufenden und schließen es, sobald das Problem gelöst ist.

Nützliche Links

Servicestatus

Aktueller Status aller fiskaly Services und Störungshistorie.

Fehlercodes

Zentrale Referenz für API-Fehlercodes und deren Behebung.

API-Referenz

Endpunkte, Schemas und Beispiele für jede fiskaly API.