Händlerzugangsdaten

Händlerzugangsdaten bei der Steuerbehörde

Um über die SIGN IT API lite auf das Webverfahren „Documento Commerciale Online” der Steuerbehörde zuzugreifen, müssen Händler über persönliche Fisconline-Zugangsdaten verfügen. Diese Zugangsdaten können von allen Steuerpflichtigen über 16 Jahren erhalten werden, einschließlich im Ausland lebender italienischer Staatsangehöriger, die eine italienische Mehrwertsteuernummer besitzen.

Die SIGN IT API ermöglicht die Eingabe von Fisconline-Zugangsdaten über den Abschnitt fiscalization der Endpunkte createTaxpayer und updateTaxpayer. Das password, der pin und die tax_id_number des Fisconline-Benutzers müssen für den spezifischen Taxpayer (COMPANY oder INDIVIDUAL) angegeben werden. Bitte beachten Sie, dass der Endbenutzer eine Schnittstelle benötigt, über die er seine Zugangsdaten regelmäßig aktualisieren kann.

📘Note

Die SIGN IT API unterstützt ausschließlich die Authentifizierung und Übermittlung von Steuerhändlerdokumenten an das Webportal der AdE über Fisconline-Zugangsdaten. Andere Authentifizierungsmethoden, wie SPID, werden nicht unterstützt, da diese alle 24 Stunden erneuert werden müssten.

Gültige Fisconline-Zugangsdaten sind nur in der LIVE-Umgebung erforderlich. In der TEST-Umgebung wird keine Validierung gegen AdE-Daten durchgeführt, daher können Platzhalter verwendet werden — wie die in unserer Postman-Sammlung bereitgestellten.

⚠️Wichtig

Das Fisconline-Passwort läuft alle 90 Tage ab (wir empfehlen eine Erneuerung alle 60 Tage). Händler sind verpflichtet, ihre Zugangsdaten regelmäßig im AdE-Portal zu aktualisieren und sie über SIGN IT lite zu übermitteln. Wie das geht, erfahren Sie in diesem Artikel: SIGN IT - How to update the FISCONLINE credentials

Die Verwendung nicht mehr gültiger Zugangsdaten führt zu einer Dienstunterbrechung, da die SIGN IT lite API sich nicht mehr mit dem Webverfahren authentifizieren kann. Aus diesem Grund wird empfohlen, eine regelmäßige Erinnerung für Händler zu implementieren (z. B. per E-Mail), um Probleme wie die Blockierung der Transaktionsdatenübermittlung zu vermeiden.

Um Integratoren dabei zu helfen, zugangsdatenbezogene Probleme schneller zu erkennen und zu beheben, führt Version 2026-06-01 einen DEGRADED-Modus für den Taxpayer ein, der automatisch ausgelöst wird, wenn Fisconline-Zugangsdatenfehler erkannt werden. Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?

Wie werden Fisconline-Zugangsdaten beantragt?

Die natürliche Person, die als Selbstständige oder als gesetzlicher Vertreter eines Unternehmens handelt, kann Fisconline-Zugangsdaten bei der Steuerbehörde beantragen. Für einen detaillierten Händlerleitfaden zur Beantragung von Fisconline-Zugangsdaten kontaktieren Sie bitte unser Vertriebsteam.

💡Tip

Der Steuerpflichtige muss sich manuell erstmalig beim Webportal der Steuerbehörde anmelden, um sicherzustellen, dass die Zugangsdaten ordnungsgemäß funktionieren, und um die Allgemeinen Geschäftsbedingungen und zusätzliche Klauseln zu akzeptieren.

Nach der ersten Anmeldung muss ein neues Passwort festgelegt werden. Das von der Steuerbehörde für den ersten Zugang bereitgestellte Passwort sollte nicht in der SIGN IT API verwendet werden.

Weitere Informationen finden Sie in den FAQs der Steuerbehörde