Elektronische Rechnungsstellung - Italien

API Invoice ermöglicht die automatisierte Verwaltung von Steuerdokumenten, vereinfacht operative Abläufe und reduziert manuelle Eingriffe. Das Ergebnis ist eine höhere Prozesseffizienz und Kostenoptimierung.

Mit Openapi können Sie den gesamten Lebenszyklus italienischer Steuerdokumente über eine einzige API verwalten: von der Unternehmenskonfiguration über den Versand von Rechnungen bis hin zur Statusüberwachung per Webhook. Die Plattform integriert sich direkt mit dem SDI und der italienischen Steuerbehörde und gewährleistet eine schnelle Integration, hohe Sicherheitsstandards und Echtzeit-Performance – auch bei großen Volumina.

Die Invoice API beschränkt sich nicht nur auf den Versand von Rechnungen: Sie ermöglicht die Verwaltung von Ausgangsrechnungen, Eingangsrechnungen und elektronischen Kassenbelegen mit automatischer digitaler Signatur, vorheriger Datenvalidierung und vollständiger Statusverfolgung der Dokumente.

Die Lösung ist robust, skalierbar und vollständig anpassbar für jede Umsatzsteuer-Identifikationsnummer. Über die Unternehmenskonfiguration können Sie auswählen, welche Services aktiviert werden sollen und wie jeder Workflow verwaltet wird:

Alle Vorgänge erfolgen asynchron: Nach dem Versand erhalten Sie automatische Status-Updates der Dokumente (z. B. DONE, RECEIVED oder ERROR) direkt in Ihrem Verwaltungssystem – ohne manuelles Polling.

Unternehmenskonfiguration und Services

POST /IT-configurations

Die Unternehmenskonfiguration ist der erste verpflichtende Schritt zur Nutzung von Invoice. Über diesen Endpoint können Sie das Unternehmen registrieren, die gewünschten Services aktivieren (Ausgangsrechnungen, Eingangsrechnungen und elektronische Kassenbelege) und Webhooks konfigurieren, um Echtzeit-Benachrichtigungen über den Dokumentstatus zu erhalten.

In dieser Phase können Sie außerdem die automatische digitale Signatur aktivieren und die für die aktiven Services erforderlichen steuerlichen Zugangsdaten angeben. Nach Abschluss der Konfiguration ist das Unternehmen bereit, Rechnungen über Invoice zu versenden, Kassenbelege über IT-receipts zu generieren und Eingangsrechnungen über Webhooks zu empfangen.

Um Lieferantenrechnungen zu empfangen, ist es erforderlich, unseren Empfängercode auf der Website der italienischen Steuerbehörde zu registrieren. Folgen Sie der Schritt-für-Schritt-Anleitung in der Dokumentation und geben Sie bei Aufforderung den folgenden Code ein: PIC7CPS

ANFRAGEBEISPIEL

Um das Unternehmen zu konfigurieren, müssen Sie eine Anfrage an POST /IT-configurations senden. Im folgenden Beispiel haben wir digitale Belege (receipts), Rechnungsversand (customer invoice) und Rechnungsempfang (supplier invoice) aktiviert.

Außerdem wurde für jedes spezifische Ereignis eine Callback konfiguriert.

{
  "fiscal_id": "YourCompanyFiscal_id",
  "name": "nameCompany",
  "email": "[email protected]",
  "receipts": true,
  "customer_invoice": true,
  "supplier_invoice": true,
  "receipts_authentication": {
    "taxCode": "FHHWMF96L52D111B",
    "password": "1234567891****d",
    "pin": "1********4"
  },
  "api_configurations": [
    {
      "event": "receipt",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "customer_invoice",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "supplier_invoice",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "receipt-error",
      "callback": {
        "url": "https://your-server.site/error"
      }
    }
  ]
}

Versand elektronischer Rechnungen

POST /IT/invoices

Über diesen Endpoint können Sie eine elektronische Rechnung an das Austauschsystem senden. Der Endpoint POST /IT/invoices übernimmt automatisch die Validierung, eine optionale digitale Signatur und die Weiterleitung an den SDI.

Die Verarbeitung erfolgt asynchron. Nach dem Versand erhalten Sie eine sofortige technische Antwort, während Statusaktualisierungen (gesendet, zugestellt, abgelehnt, abgeschlossen) über die während des Onboardings konfigurierten Webhooks übermittelt werden.

Dieser Ansatz ermöglicht die Verarbeitung großer Dokumentenvolumina, ohne die Anwendungs-Workflows zu blockieren.

{
  "data": {
    "id": "string",
    "state": "NEW",
    "direction": "incoming",
    "fiscal_id": "string",
    "type": "string",
    "document_number": "string",
    "issue_date": "2026-02-09",
    "total_gross_amount": 0,
    "sender": {
      "name": "string",
      "vat_id": "string",
      "tax_code": "string",
      "street": "string",
      "city": "string",
      "zip": "string",
      "province": "string",
      "country_code": "string",
      "phone": "string",
      "email": "string"
    },
    "recipient": {
      "name": "string",
      "vat_id": "string",
      "tax_code": "string",
      "street": "string",
      "city": "string",
      "zip": "string",
      "province": "string",
      "country_code": "string",
      "phone": "string",
      "email": "string"
    },
    "details": {
      "sdi_id": "string",
      "sdi_filename": "string",
      "sdi_status": "Delivered",
      "sdi_message": "string",
      "sdi_update_date": "string",
      "invoice_date": "string"
    }
  }
}

Nach dem Versand der Rechnung können Sie den Status über Webhooks überwachen oder die Details über die Abfrage-Endpoints abrufen. GET IT-Invoice speichert den vollständigen Dokumentenverlauf einschließlich der SDI-Ergebnisse.

Überwachung des Rechnungsstatus

Nach dem Versand übernimmt Invoice automatisch den gesamten Kommunikationsprozess mit dem SDI.

Der Rechnungsstatus wird asynchron aktualisiert und automatisch per Webhook übermittelt, sodass Sie die Ergebnisse der Dokumente in Echtzeit kennen, ohne die APIs manuell abfragen zu müssen.

Dank der während des Onboardings konfigurierten Webhooks erhalten Sie Status-Updates zu Ausgangs- und Eingangsrechnungen direkt in Ihrem Verwaltungssystem.

Dokumentenabfrage

GET /IT-invoices

Dieser Endpoint ermöglicht es, die Liste der vom System verwalteten Rechnungen abzurufen, sowohl Ausgangs- als auch Eingangsrechnungen.

Sie können diesen Service verwenden, um einen vollständigen Überblick über die Dokumente zu erhalten, Rechnungen nach Status oder Datum zu filtern und schnell die wichtigsten Informationen einzusehen, ohne die vollständigen Details jedes Dokuments abrufen zu müssen.

Er ist ideal zum Erstellen von Dashboards, Dokumentlisten oder zur periodischen Synchronisierung des allgemeinen Rechnungsstatus mit Ihrem Verwaltungssystem.

Sie können jederzeit die Liste der gesendeten und empfangenen Dokumente einsehen oder die Details einer einzelnen Rechnung über die API abrufen.

Jede Rechnung verfügt über einen vollständigen Verlauf einschließlich der SDI-Ergebnisse und ermöglicht eine zentrale Verwaltung von Ausgangs- und Eingangsrechnungen.

{
  "id": "679ca42e016df7",
  "state": "DONE",
  "direction": "outgoing",
  "document_number": "123",
  "issue_date": "2026-01-15",
  "total_gross_amount": 250.00,
  "details": {
    "sdi_status": "Delivered"
  }
}

Dank der während des Onboardings konfigurierten Webhooks erhalten Sie Statusaktualisierungen automatisch in Ihrem Verwaltungssystem, ohne die APIs kontinuierlich abfragen zu müssen.

Rechnungsdetail

GET /IT-invoices/{id}

Dieser Endpoint liefert alle Informationen zu einer einzelnen Rechnung, die über die ID identifiziert wird.

Die Detailansicht enthält den aktuellen Dokumentstatus, die Richtung (Ausgang oder Eingang), die wichtigsten Rechnungsdaten sowie die technischen SDI-Ergebnisse im Feld details.sdi_status.

Dieser Service sollte verwendet werden, wenn Sie den genauen Status einer Rechnung überprüfen oder vollständige Informationen zu einem bestimmten Dokument anzeigen müssen.

Import externer Rechnungen

POST /IT-invoice_import

IT-Invoice ermöglicht es außerdem, Rechnungen, die über andere Kanäle erstellt oder übertragen wurden, in das System zu importieren, um ein einheitliches Archiv aller Steuerdokumente zu pflegen.

Diese Funktion ist nützlich, um die Verwaltung von Rechnungen aus externer Software oder früheren Integrationen zu zentralisieren und Status, Details und Metadaten über einen API-Aufruf einzusehen.

Nach dem Import wird die Rechnung wie jedes andere Dokument behandelt: Sie kann über die API abgerufen und in Monitoring-Workflows eingebunden werden.

{
  "invoice": "PD94bWwgdmVyc2lvbj0iMS4wIi...",
  "details": {
    "sdi_id": "1234567",
    "sdi_filename": "IT01234567890_00001.xml",
    "sdi_status": "Delivered",
    "sdi_message": "string",
    "sdi_update_date": "2026-02-04T14:15:20.413Z",
    "invoice_date": "2026-02-04"
  }
}

Auf diese Weise können Sie über Invoice gesendete Rechnungen und Rechnungen aus externen Systemen innerhalb eines einzigen operativen Workflows verwalten.

Webhooks und Echtzeit-Benachrichtigungen

Invoice verwendet ein Webhook-System, um jede Statusaktualisierung von Steuerdokumenten automatisch zu übermitteln.

Während der Unternehmenskonfiguration können Sie einen oder mehrere Callback-Endpoints definieren, um Ereignisse zu Ausgangsrechnungen, Eingangsrechnungen und elektronischen Kassenbelegen zu empfangen. So wird Ihr Verwaltungssystem in Echtzeit aktualisiert.

Webhooks ermöglichen es, Ereignisse wie die folgenden abzufangen:

Dieser asynchrone Ansatz macht die Integration effizienter und skalierbarer, insbesondere bei hohen Volumina.

{
  "event": "customer_invoice",
  "data": {
    "id": "679ca42e016df7",
    "state": "DONE",
    "sdi_status": "Delivered"
  }
}

Für wen Invoice geeignet ist

Invoice richtet sich an alle Organisationen, die die Verwaltung von Steuerdokumenten direkt in ihre Systeme integrieren und automatisieren möchten – von Softwarehäusern und Entwicklern, die elektronische Rechnungsstellung per API in ihre Verwaltungssysteme integrieren wollen, über E-Commerce-Plattformen, die für jede Transaktion automatisch Rechnungen oder elektronische Kassenbelege ohne manuelle Schritte ausstellen müssen, bis hin zu Unternehmen, die Buchhaltungsprozesse automatisieren, die Verwaltung von Steuerdokumenten zentralisieren und operative Fehler reduzieren möchten. Dank der modularen Struktur und der direkten Integration mit dem SDI und der italienischen Steuerbehörde eignet sich Invoice sowohl für kleine Volumina als auch für Enterprise-Projekte mit hoher Last.