Senden Sie elektronische Belege und Rechnungen an die Steuerbehörde einfach, schnell und besonders sicher
Automatisieren Sie die Echtzeitübermittlung von Geschäftsdokumenten und elektronischen Rechnungen über eine API und gewährleisten Sie gesetzliche Konformität, operative Zuverlässigkeit und höchste Sicherheit.
Die erforderlichen Informationen sind:
- Codice Fiscale
- Firmenname
- Codice Fiscale
- Passwort
- PIN
Zusätzlich muss das Feld „receipts“ auf true gesetzt werden.
Die Daten müssen von der Person stammen, die für den Versand der Belege verantwortlich ist. Wenn Sie also für Dritte entwickeln, müssen die Daten des Endkunden verwendet werden.
Die Zugangsdaten müssen vierteljährlich aktualisiert werden, da die italienische Steuerbehörde die Zugangsdaten regelmäßig ablaufen lässt.
In dieser Phase können auch die Ereignistypen konfiguriert werden, für die Benachrichtigungen empfangen werden sollen.
Um ein Unternehmen korrekt für die Verwaltung der B2B- und öffentlichen Verwaltungselektronischen Rechnungsstellung zu konfigurieren, werden folgende Daten benötigt:
- Steueridentifikationsnummer des Unternehmens (Codice Fiscale oder Umsatzsteuer-Nummer)
- Firmenname
- E-Mail-Adresse für Mitteilungen und Benachrichtigungen
(Die angegebene E-Mail-Adresse kann nach Erstellung der Konfiguration nicht mehr geändert werden.)
Während der Konfiguration muss außerdem angegeben werden, wie der Dienst genutzt werden soll:
- Nur Versand von Ausgangsrechnungen (customer_invoice)
- Nur Empfang von Eingangsrechnungen (supplier_invoice)
- Vollständige Verwaltung des Rechnungszyklus (aktiv und passiv)
Um die gewünschten Funktionen zu aktivieren, müssen die entsprechenden Felder in der Anfrage auf true gesetzt werden.
Es ist auch möglich, die Arten von Ereignissen zu konfigurieren, für die Benachrichtigungen empfangen werden sollen.
Wichtiger Hinweis zum Empfang passiver Rechnungen
Um Rechnungen von Lieferanten korrekt zu empfangen, reicht es nicht aus, das Feld supplier_invoice auf true zu setzen. Unser Empfänger-Code (PIC7CPS) muss auf der Website der italienischen Steuerbehörde (Agenzia delle Entrate) registriert werden, um den Empfangskanal korrekt zuzuordnen.
Ja. Mit Openapi können Sie für dasselbe Unternehmen sowohl den gesamten B2B- und öffentlichen Verwaltungselektronischen Rechnungszyklus als auch den Versand kommerzieller Dokumente (elektronische Belege) an die italienische Steuerbehörde über eine einzige API verwalten.
Während der Konfiguration müssen lediglich die folgenden Felder auf true gesetzt werden:
- customer_invoice (Ausgangsrechnungen)
- supplier_invoice (Eingangsrechnungen)
- receipts (kommerzielle Dokumente)
Auf diese Weise können alle erforderlichen Funktionen über eine einzige Integration aktiviert werden.
Ja, Sie können mehrere Unternehmen aktivieren, indem Sie das Konfigurationsverfahren über das dedizierte Endpoint (Business Registry Configuration) abschließen.
Nein, aber über 10 Konfigurationen hinaus wird eine zusätzliche Gebühr von 1 € berechnet.
Ja. Elektronische Rechnungen an die öffentliche Verwaltung werden vor dem Versand automatisch vom System signiert.
Beim Versand können Sie jedoch Ihre eigenen Zertifikatsdaten über den Dienst EU-QES_automatic bereitstellen, wenn Sie eine personalisierte digitale Signatur verwenden möchten.
Ohne ein personalisiertes Zertifikat wird die Standard-Signatur des Dienstes angewendet.
Ja, Sie können die Rechnungsverläufe über das Endpoint POST /IT-invoices_import importieren.
Ja. Über das Endpoint PATCH /IT-configuration können jederzeit verschiedene Informationen aktualisiert werden, darunter:
- Aktivierung oder Deaktivierung des elektronischen Belegdienstes (receipts)
- Authentifizierungsdaten
- Benachrichtigungstypen für Ereignisse
Wichtiger Hinweis: Die während der Konfiguration angegebene E-Mail-Adresse kann nicht geändert werden. Es ist daher wichtig, von Anfang an die korrekte Adresse anzugeben, da diese für alle Mitteilungen und Benachrichtigungen verwendet wird.
Nein. Wenn Sie keine passiven Rechnungen empfangen müssen, ist keine Registrierung eines Empfänger-Codes erforderlich.
Der Empfänger-Code für den Rechnungsempfang lautet: PIC7CPS
Die Hauptursachen können folgende sein:
- Die Konfiguration wurde nicht korrekt abgeschlossen.
- Kein verfügbares Guthaben.
Um passive Rechnungen zu empfangen, müssen Sie:
- Die Konfiguration über POST /api_configurations durchführen.
- Den Wert supplier_invoice gemäß der Dokumentation setzen. Die Rechnungen werden dann an den angegebenen Callback gesendet.
Anschließend können sie über GET /invoices abgerufen werden.
WICHTIG: Wenn das verfügbare Guthaben aufgebraucht ist, werden passive Rechnungen nicht mehr zugestellt.
Ja. Beim Abrufen eines einzelnen Belegs können Sie ihn im Standard-JSON-Format oder als PDF herunterladen. Um das PDF zu erhalten, setzen Sie einfach den Content-Type-Header auf "application/pdf".
Benachrichtigungen können für folgende Ereignisse konfiguriert werden:
- receipt: wenn ein neuer Beleg gesendet und bereit ist
- receipt-credentials: wenn es Aktualisierungen der Zugangsdaten gibt
- receipt-retry: wenn die Kommunikation mit dem Portal der Agenzia delle Entrate fehlschlägt und der Beleg erneut gesendet wird
- customer-invoice: wenn sich der Status einer Ausgangsrechnung ändert
- supplier-invoice: wenn sich der Status einer Eingangsrechnung ändert
- receipt-error: wenn die italienische Steuerbehörde (AdE) einen Fehler für einen elektronischen Beleg zurückgibt
Das System archiviert und stellt Antworten zu Sendungen, Stornierungen und Rückgaben von Belegen 12 Monate lang zur Verfügung. Nach Ablauf dieser Frist werden die Daten automatisch gelöscht.
Der Dienst sendet elektronische Belege in Echtzeit. Die Reaktionszeiten hängen von der italienischen Steuerbehörde ab.
Die Kosten fallen bei Versand, Stornierung und Rückgabe an.
Ab 10 Business-Konfigurationen wird eine zusätzliche Gebühr von 1 € erhoben.
Im Bereich „Nutzung“ auf API-Ebene können Sie alle durchgeführten Anfragen überwachen, sowohl kostenlose als auch über Abonnement oder Guthaben.
Es stehen zwei Ansichtsmodi zur Verfügung:
- Grafische Ansicht: monatlich oder jährlich
- Textzusammenfassung: mit detaillierter Verbrauchsanzeige
Elektronischer Beleg: ab 0,009 € mit Abonnement oder 0,019 € bei Abrechnung über Guthaben
Elektronische Rechnungen: ab 0,049 € mit Abonnement oder 0,154 € bei Abrechnung über Guthaben
Ja, Sie können ein Jahresabonnement aktivieren, um die Kosten pro API-Aufruf zu reduzieren, sowohl für elektronische Belege als auch für elektronische Rechnungen.
Im Abschnitt „Abonnements“ der jeweiligen API können Sie:
- Verfügbare Optionen mit Preisen und Ersparnissen einsehen
- Das gewünschte Abonnement direkt über die Benutzeroberfläche aktivieren