Elektronische Rechnungen und elektronische Kassenbelege einfach, schnell und sicher versenden
Automatisieren Sie den Versand von B2B- und B2G-E-Rechnungen in den wichtigsten europäischen Ländern sowie von elektronischen Kassenbelegen in Italien über eine einzige API. Profitieren Sie von regulatorischer Konformität, hoher Betriebssicherheit und maximaler Zuverlässigkeit.
Der Service unterstützt derzeit Italien, Frankreich und Deutschland. Jedes Land hat eigene gesetzliche Vorgaben und Übermittlungsverfahren, die jedoch alle über eine einzige REST API verwaltet werden können.
Ja. Mit derselben API können Unternehmen konfiguriert und die elektronische Rechnungsstellung in allen unterstützten Ländern verwaltet werden. Lediglich einige Felder sowie die von den jeweiligen nationalen Vorschriften vorgegebenen Übermittlungsverfahren unterscheiden sich von Land zu Land.
Obwohl die Integration über eine einzige REST API erfolgt, gelten in jedem Land unterschiedliche gesetzliche Vorgaben, Formate und Übermittlungskanäle.
- Italien: Elektronische Rechnungen werden über das Sistema di Interscambio (SDI) übermittelt, das den Versand, den Empfang und die Statusbenachrichtigungen verwaltet.
- Frankreich: Die elektronische Rechnungsstellung erfolgt gemäß den französischen Vorschriften über das Peppol-Netzwerk und autorisierte Kanäle für den Austausch elektronischer Dokumente.
- Deutschland: Die elektronische Rechnungsstellung verwendet die nach deutschem Recht vorgesehenen Standards wie XRechnung und ZUGFeRD, wobei die Übermittlung – sofern vorgesehen – über Peppol erfolgt.
Die Openapi API verwaltet die Unterschiede zwischen den einzelnen Ländern automatisch und ermöglicht so die Integration einer einzigen Lösung für die Unternehmenskonfiguration sowie den Versand, den Empfang und die Überwachung elektronischer Rechnungen in allen unterstützten Märkten.
Für Vereine und Genossenschaften erfolgt die Aktivierung des Kassenbon-Services über ein geführtes Verfahren, das von unserem Support-Team betreut wird.
So beantragen Sie die Aktivierung:
- Kaufen Sie das Paket Premium-Support (2 Stunden)
- Eröffnen Sie ein Support-Ticket und geben Sie die Anfrage zur Aktivierung des Kassenbon-Services für einen Verein/eine Genossenschaft an
Ein Mitarbeiter unseres Support-Teams wird sich schnellstmöglich mit Ihnen in Verbindung setzen, um Sie durch die Konfiguration zu begleiten.
Während des Prozesses müssen die Daten des gesetzlichen Vertreters angegeben werden. Darüber hinaus muss der gesetzliche Vertreter über einen Zugang zum Cassetto Fiscale (italienisches Steuerportal) mit eigenen Zugangsdaten (Benutzername und Passwort) verfügen, die zur erfolgreichen Aktivierung des Services erforderlich sind.
Ja, der Dienst unterstützt die Verwaltung mehrerer Unternehmen. Um die Rechnungsstellung für jedes Unternehmen zu aktivieren, führen Sie einfach den entsprechenden Konfigurationsprozess über den Endpunkt Business Registry Configuration durch und wiederholen Sie diesen Vorgang für jedes Unternehmen, das Sie aktivieren möchten.
Nach Abschluss der Konfiguration kann jedes Unternehmen den Dienst unabhängig mit seinen eigenen Rechnungseinstellungen nutzen.
Nein, aber über 10 Konfigurationen hinaus wird eine zusätzliche Gebühr von 1 € berechnet.
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.
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, elektronische Rechnungen an die öffentliche Verwaltung werden vor dem Versand automatisch vom System signiert.
Alternativ ist es möglich, ein individuelles Signaturzertifikat zu verwenden, indem die automatische qualifizierte elektronische Signatur (QES Automatic) über Openapi mittels des entsprechenden Endpunkts POST /certificates/namirial-automatic aktiviert wird. Nach der Aktivierung müssen die Zugangsdaten des Dienstes im Header der Anfrage zur Rechnungsübermittlung angegeben werden, damit die Signatur mit dem konfigurierten Zertifikat erfolgen kann.
Bei Verwendung einer benutzerdefinierten Signatur fallen zusätzlich zu den Kosten für die Zertifikatsaktivierung Gebühren pro Signatur in Höhe von 0,013 € im Abonnementmodell oder 0,045 € bei Abrechnung über Guthabenaufladung an.
Ohne ein benutzerdefiniertes Zertifikat wird automatisch die standardmäßige digitale Signatur des Dienstes angewendet.
Der Empfänger-Code für den Rechnungsempfang lautet: PIC7CPS
Um die Konfiguration abzuschließen, können Sie diesen Code direkt im entsprechenden Bereich des Portals der italienischen Steuerbehörde registrieren. Weitere Details finden Sie in unserem Leitfaden zur Einrichtung des Empfängercodes.
Nein. Wenn Sie keine passiven Rechnungen empfangen müssen, ist keine Registrierung eines Empfänger-Codes erforderlich.
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.
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
Italien
- Elektronische Kassenbons: ab 0,009 € mit Abonnement oder 0,019 € bei nutzungsbasierter Abrechnung.
- Elektronische Rechnungen: ab 0,049 € mit Abonnement oder 0,154 € bei nutzungsbasierter Abrechnung.
Frankreich
- Elektronische Rechnungen: ab 0,017 € mit Abonnement oder 0,090 € bei nutzungsbasierter Abrechnung.
Deutschland
- Elektronische Rechnungen: ab 0,017 € mit Abonnement oder 0,090 € bei nutzungsbasierter Abrechnung.
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