Der Service ermöglicht das schnelle und sichere Senden von Steuerbelegen an die Agentur der Einnahmen (Rechnungen und Quittungen), um die Effizienz zu steigern und Kosten zu senken. Die API-Lösung erfordert keine monatliche Gebühr, und die Zahlung für jede einzelne Rechnung beginnt bei 0,009€.
Der Service wurde entwickelt, um alle Bedürfnisse unserer Kunden zu erfüllen, wie zum Beispiel das Senden von Quittungen (Online-Handelsdokumenten), Stornierungen, Rückgaben, Rabatten, verschiedene Zahlungsmethoden (z. B. Restaurantgutscheine oder Barzahlungen). Die Quittungen werden in Echtzeit übertragen und bis zur positiven Antwort der Agentur der Einnahmen verwaltet.
Die Einführung der elektronischen Quittung macht die Pflicht zum Führen des Kassabuches und die Aufbewahrung von Kopien der an Kunden ausgegebenen Handelsdokumente (wie es früher bei den Kopien der Steuerquittungen der Fall war) überflüssig, wodurch Kosten und Zeit für die Aktivitäten optimiert werden.
Die elektronische Quittung gehört zur API Invoice, der neuen API, die darauf ausgelegt ist, Rechnungsstellungsdienste nicht nur in Italien, sondern auch in Europa und international verfügbar zu machen.
Unsere Lösung lässt sich leicht in bestehende Verwaltungssysteme integrieren und gewährleistet die Einhaltung der italienischen Vorschriften sowie eine effiziente Verwaltung von Steuerdokumenten. Es ist möglich, die Übertragung von Quittungen für mehrere Unternehmen zu konfigurieren und zu verwalten (Business Registry Configuration).
BUSINESS KONFIGURATION (UNTERNEHMENSDATEN)
Bei der ersten Anfrage müssen die Unternehmensdaten der Tätigkeit festgelegt werden, die Steuerbelege senden möchte. Im Falle von Integratoren für Drittfirmen müssen die Informationen des Endkunden angegeben werden, insbesondere:
- Steueridentifikationsnummer
- Firmenname
- Authentifizierungsdaten der Agentur der Einnahmen (Steuer-ID, Passwort, PIN)
- Gegebenenfalls Benachrichtigungen für bestimmte Ereignisse
Die Steuernummer muss der Person gehören, die für das Senden der elektronischen Belege im Namen des Unternehmens verantwortlich ist, und muss mit der in dem privaten Bereich der Steuerbehörde hinterlegten übereinstimmen. Für weitere Details empfehlen wir, den entsprechenden Leitfaden zu konsultieren.
BEISPIEL KONFIGURATIONSANFRAGE
POST /IT-configurations
Die Anfrage muss unter Bezugnahme auf den folgenden Endpunkt gestellt werden und die Steuer-ID des Unternehmens übermittelt werden:
https://invoice.openapi.com/IT-configurations/{fiscal_id}
Im Payload müssen die oben angegebenen Daten übermittelt werden:
{
"fiscal_id": "string",
"name": "string",
"email": "string",
"receipts": "true",
"supplier_invoice": false,
"legal_storage": false,
"signature": false,
"receipts_authentication": {
"taxCode": "XXXXXXXXXXXXX",
"password": "1234567891****d",
"pin": "1********4"
},
"api_configurations": [
{
"event": "receipt",
"callback": {
"url": "https://your-server.site/123232"
}
},
{
"event": "receipt-error",
"callback": {
"url": "https://your-server.site/error"
}
}
]
}
In dieser Phase ist es wichtig, den Service "receipt" auf true zu setzen, um den Dienst für den Versand von elektronischen Quittungen zu aktivieren.
Die bestehenden Konfigurationen eines Unternehmens können jederzeit durch eine PATCH-Anfrage und die Angabe der Steuer-ID aktualisiert werden.
STEUERBELEGE SENDEN
POST /IT-receipts
Beim Senden einer Steuerquittung können ein oder mehrere Artikel in derselben Quittung gesendet werden.
BEISPIEL FÜR EINE ANFRAGE ZUM SENDEN EINER ELEKTRONISCHEN QUITTUNG
https://invoice.openapi.com/IT-receipts
Bei der Anfrage zum Senden einer Quittung müssen folgende Informationen zu jedem einzelnen Artikel in der Quittung übermittelt werden:
- Quantität (quantity)
- Beschreibung (description)
- Einzelpreis mit MwSt. (unit_price*)
- MwSt.-Code (vat_rate_code*)
- Rabattbetrag für den Artikel in Euro (discount*)
- Gratisartikel (complimentary*)
- Betrag in bar bezahlt in Euro.
Es ist auch möglich, andere Elemente zu den Zahlungsmodalitäten anzugeben, wie z. B. der elektronisch bezahlte Betrag oder die Bezahlung per Restaurantticket und angewendete Rabatte.
Dies ist ein Beispiel für das Payload der Anfrage zum Senden einer elektronischen Quittung:
{
"fiscal_id": "YourCompanyFiscal_id",
"items": [
{
"quantity": 11,
"description": "test",
"unit_price": 10,
"vat_rate_code": "22",
"discount": 0,
"complimentary": false,
"cash_paid": false
}
],
"total": 10,
"transaction_time": "2021-10-31 13:43:35"
}
ANTWORT AUF DIE BELEGSENDUNG
Die Antwort enthält alle zuvor angegebenen Informationen sowie:
- ID: Eindeutiger Bezeichner des Belegs.
- Transaktions-ID: Bezeichner, der vom Finanzamt dem Dokument zugewiesen wird.
- Erstellungsdatum des Dokuments
- Lottocode
- Gegebenenfalls Fehlercode und Fehlermeldung
- Belegnummer und -datum
- Status des Belegs (new, retry, submitted, ready, failed, voided)
- Typ (Verkauf, Rückgabe, Stornierung)
- Gesamtbetrag des Belegs, inkl. MwSt.
{
"data"
{
"fiscal_id": "YourCompanyFiscal_id",
"items": [
{
"quantity": 11,
"description": "test",
"unit_price": 10,
"vat_rate_code": "22",
"discount": 0,
"complimentary": true
}
],
"cash_payment_amount": 4.5,
"id": "679cd95***************23",
"invoice_issuing": false,
"services_uncollected_amount": 0,
"goods_uncollected_amount": 0,
"electronic_payment_amount": 0,
"ticket_restaurant_payment_amount": 0,
"ticket_restaurant_quantity": 0,
"discount": 0,
"linked_receipt": "string",
"lottery_code": null,
"created_at": "2025-01-31T14:08:20.000Z",
"error_message": null,
"error_code": null,
"total_amount": 0,
"document_number": "",
"document_date": null,
"transaction_id": null,
"owner": "[email protected]",
"create_timestamp": 1738332500,
"status": "new",
"type": "sale"
},
"success": true,
"message": "",
"error": null
}
Der Service ermöglicht es jederzeit, auf die Liste der Belege zuzugreifen und diese nach der Steuernummer, der Belegnummer, dem Status, dem Erstellungsdatum des Dokuments oder des Belegs zu filtern.
Unsere API für die Übermittlung von Steuerbelegen in Italien ist die ideale Lösung, um die Verwaltung von Steuerdokumenten zu vereinfachen und zu modernisieren. Mit einer schnellen und flexiblen Integration ermöglicht sie die Automatisierung des Versands von Belegen sicher und effizient, gewährleistet die vollständige Einhaltung der geltenden Vorschriften und ist ideal für Unternehmen wie Filialketten, den Lebensmitteleinzelhandel (GDO), Verwaltungssysteme, die ihre Betriebsabläufe optimieren und Fehler, Papierverbrauch sowie Bearbeitungszeiten reduzieren möchten.
Brauchen Sie Hilfe?
Haben Sie die gewünschte Antwort nicht gefunden?
Füllen Sie alle Details aus, wir werden uns so schnell wie möglich bei Ihnen melden!
Der Service für elektronische Belege ist eine API, mit der Handelsdokumente einfach, schnell und sicher versendet werden können. Mit dieser Lösung können Sie die Übermittlung von elektronischen Belegen in Echtzeit verwalten, auch bei großen Volumina, und Vorgänge wie Stornierungen, Rücksendungen, Rabatte und verschiedene Zahlungsmethoden (z. B. Restaurantgutscheine und Barzahlungen) abwickeln.
Der Service ist Teil der API Invoice, einer neuen API, die nicht nur in Italien, sondern auch auf europäischer und internationaler Ebene Fakturierungslösungen bietet.
Die API zum Versenden von Belegen ist die ideale Lösung, um die Verwaltung von Steuerdokumenten zu vereinfachen und zu modernisieren. Dank einer schnellen, flexiblen und sicheren Integration können die Belege automatisiert versendet werden, wobei die vollständige Einhaltung der geltenden Vorschriften gewährleistet wird. Sie eignet sich perfekt für Unternehmen wie Filialketten, den Großhandel (GDO) und Verwaltungssoftware, die ihre operativen Abläufe optimieren, den Papierverbrauch reduzieren und Fehler minimieren möchten, um die Bearbeitungszeit zu verkürzen.
Die aktuelle Gesetzgebung verlangt nicht, dass dem Kunden eine Kopie des Belegs ausgehändigt wird. Es ist jedoch möglich, die in der Antwort enthaltenen Daten zu verwenden, um eine PDF-Datei zu erstellen, die digital versendet oder ausgedruckt werden kann.
Der Service wird in Echtzeit bereitgestellt. Wenn es jedoch Probleme mit der Agenzia delle Entrate gibt, bleibt die Anfrage in der Warteschlange, bis die erfolgreiche Durchführung bestätigt wurde.
Der Service für elektronische Belege hat keine Aktivierungsgebühren. Die Kosten richten sich nach dem Verbrauch: Jede Anfrage für das Senden, Stornieren oder Zurückgeben eines Belegs kostet ab 0,009 € im Abonnement oder 0,019 € pro Einzelanfrage mit Guthaben.
Die Entscheidung zwischen der Ausstellung einer Rechnung oder eines Kassenbons hängt hauptsächlich von der Art des Kunden und der Transaktion ab:
-
Geschäftskunde oder professioneller Kunde (B2B):
- Pflicht zur Rechnungsausstellung: Wenn der Kunde ein Unternehmen, ein Freiberufler oder eine Organisation ist (d. h. über eine Umsatzsteuer-Identifikationsnummer verfügt), ist die Ausstellung einer Rechnung gesetzlich vorgeschrieben. Dies ermöglicht unter anderem die Mehrwertsteuerabsetzung und eine korrekte Kostenabrechnung.
- Elektronische Rechnung: Für Transaktionen zwischen in Italien ansässigen Unternehmen (und für Geschäfte mit öffentlichen Verwaltungen) ist die Nutzung der elektronischen Rechnungsstellung gesetzlich vorgeschrieben.
-
Privatkunden (B2C):
- Kassenbon: Bei Einzelhandelsverkäufen an Endverbraucher ohne Umsatzsteuer-Identifikationsnummer reicht in der Regel die Ausstellung eines Kassenbons über eine zugelassene Registrierkasse aus.
- Rechnung auf Anfrage: Wenn ein Privatkunde ausdrücklich eine Rechnung anfordert (z. B. für Garantiezwecke oder andere Gründe), ist der Anbieter verpflichtet, diese auszustellen, auch wenn es sich um eine Endkundentransaktion handelt.
Die von Openapi angebotenen APIs gehören zu den Dienstleistungen, die von der italienischen Steuerbehörde als „Velocizzatori“ (Beschleuniger) definiert wurden.
Zusätzlich zur Einhaltung aller von der Steuerbehörde festgelegten Richtlinien werden die Kundenanmeldedaten (gemäß den Vorschriften) nicht von Openapi gespeichert. Stattdessen wird nur deren Fingerabdruck gespeichert (eine Einweg-Verschlüsselung, die es nicht ermöglicht, die Anmeldedaten zu verstehen, sondern nur zu überprüfen, ob sie sich geändert haben).
Die Anmeldedaten werden daher stets ausschließlich vom Nutzer verwaltet, der sie innerhalb des „Beschleunigers“ verwendet, um die Übermittlung oder den Abruf der Transaktionsdaten abzuschließen.
Weitere Details finden Sie in der offiziellen Mitteilung der italienischen Steuerbehörde.
Ja, um Quittungen ausstellen zu können, muss man sich auf dem Agentur der Einnahmen anmelden.
Danach müssen die folgenden Schritte befolgt werden:
1. Vergewissern Sie sich, dass der Benutzername in der oberen rechten Ecke der des Unternehmens ist
2. Gehen Sie im linken Menü auf den Punkt Ihr Profil und dann auf den Punkt Zuordnungen
3. Klicken Sie auf Zuweisungen als Manager verwalten
4. Klicken Sie auf Zuweisung hinzufügen
5. Geben Sie in das Feld Steuercode die CF der Person ein, die rechtlich für den Versand der Quittungen verantwortlich ist, und wählen Sie im Feld Art der Zuweisung den Wert Zuweisung und speichern Sie
BITTE BEACHTEN SIE: der Steuercode ist derselbe, der bei der Geschäftskonfiguration (POST /IT-Konfiguration) in 'taxCode', unter 'receipts_authentication', angegeben werden muss
6. Klicken Sie in der aktualisierten Agentenliste unter dem soeben eingegebenen Wert auf „Actions“ und „Manage Services“.
7. Es öffnet sich eine Liste mit auswählbaren Einträgen. Klicken Sie auf Dienste für und dann auf Umsatzsteuerdatenübermittlung.
Wählen Sie den Punkt Akkreditierung und Zählgeräte Personal und speichern Sie
Kohlenstofffreie Energie für unsere Cloud 
Low CO2
Openapi SpA Unipersonale - Gesellschaft unter der Leitung und Kontrolle der Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Rom - Handelsregister REA 1378273 - Stammkapital € 50.000,00 eingezahlt – MwSt.-Nr. IT12485671007 - Empfängercode 'USAL8PV' - PEC: 
Openapi ist zertifiziert: Qualitätsmanagementsystem UNI EN ISO 9001:2015 - Datenqualität ISO 25012:2014 - Sicherheitsmanagement ISO/IEC 27001:2022 - Geschlechtergleichstellung gemäß UNI PdR 125:2022
Alle Preise verstehen sich zuzüglich eventueller MwSt., eventuell anfallender Stempelsteuern, Registrierungsgebühren und/oder sonstiger Steuern oder Abgaben, sofern diese fällig sind. Alle auf dem Portal aufgeführten Logos sind urheberrechtlich geschützt und Eigentum der jeweiligen Inhaber.
