Elektronische Rechnungsstellung einfach, schnell und mit hohen Sicherheitsstandards
Automatisiert das Senden, Signieren, Empfangen und digitale Speichern von elektronischen Rechnungen über API
All das Wissen, das Sie benötigen
Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.
Nützliche Tipps für den Einstieg
Elektronische Rechnungsstellung SDI
Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.
Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.
Unternehmen konfigurieren
Das Unternehmen mit /business_registry_configurations konfigurieren und auswählen, ob normale, signierte oder signierte und archivierte Rechnungen erstellt werden sollen. Wenn die Archivierung aktiviert wurde, werden die Zugangsdaten an die in der Konfiguration angegebene E-Mail-Adresse gesendet. Achtung: E-Mail-Adresse und Umsatzsteuer-Identifikationsnummer sind eindeutige Daten. Diese Operation muss nur durchgeführt werden, wenn das Unternehmen zum ersten Mal eingerichtet wird.
Benachrichtigungen konfigurieren, um Genehmigungen und Ablehnungen zu verwalten
Die Callbacks mit /api_configurations konfigurieren und eine oder mehrere dieser Optionen festlegen, wenn erforderlich: 'supplier-invoice' (passive Rechnung), 'customer-invoice' (aktive Rechnung), 'customer-notification' (Benachrichtigung über Ablehnung oder Annahme), 'legal-storage-missing-vat', 'legal-storage-receipt' (Eingang des Archivs). Auf diese Weise erhalten Sie einen Anruf mit dem Rechnungsobjekt direkt an die von Ihnen bereitgestellte URL.
Diese Operation muss nur durchgeführt werden, wenn das Unternehmen zum ersten Mal eingerichtet wird.
Wenn Sie sich für den passiven Zyklus interessieren, sollten Sie diese Anleitung zuerst befolgen: https://openapi.it/en/blog/register-recipient-code-italian-revenue-agency.html
Diese Operation muss nur durchgeführt werden, wenn das Unternehmen zum ersten Mal eingerichtet wird.
Wenn Sie sich für den passiven Zyklus interessieren, sollten Sie diese Anleitung zuerst befolgen: https://openapi.it/en/blog/register-recipient-code-italian-revenue-agency.html
Senden Sie die erste Rechnung
Verwenden Sie die Endpunkte
/invoices,
/invoices_signature,
/invoices_legal_storage oder
/invoices_signature_legal_storage je nach Bedarf. Diese ermöglichen es Ihnen, die Rechnung sowohl im XML-Format (kompatibel mit dem XML-Rechnungsstandard) als auch im JSON-Format zu senden.
Sobald die Rechnung gesendet wurde, wird die Benachrichtigung an die in der Benachrichtigungskonfiguration angegebene URL gesendet.
Die Antwort auf eine Rechnungsübermittlung enthält eine uuid, die später verwendet werden kann, um die Rechnung abzurufen /invoices, eventuelle Benachrichtigungen /invoices_notifications oder die Rechnung herunterzuladen /invoices_download
Sobald die Rechnung gesendet wurde, wird die Benachrichtigung an die in der Benachrichtigungskonfiguration angegebene URL gesendet.
Die Antwort auf eine Rechnungsübermittlung enthält eine uuid, die später verwendet werden kann, um die Rechnung abzurufen /invoices, eventuelle Benachrichtigungen /invoices_notifications oder die Rechnung herunterzuladen /invoices_download
- Oas file url https://console.openapi.com/oas/de/sdi.openapi.json
- Fork or import with Postman
- Production domain sdi.openapi.it
- Sandbox domain test.sdi.openapi.it
-
Production Scopes 21
- GET sdi.openapi.it/invoices
- POST sdi.openapi.it/invoices
- GET sdi.openapi.it/invoices_download
- DELETE sdi.openapi.it/business_registries
- POST sdi.openapi.it/business_registry_configurations
- POST sdi.openapi.it/api_configurations
- DELETE sdi.openapi.it/api_configurations
- GET sdi.openapi.it/api_configurations
- DELETE sdi.openapi.it/business_registry_configurations
- GET sdi.openapi.it/business_registry_configurations
- GET sdi.openapi.it/invoices_notifications
- POST sdi.openapi.it/supplier_invoice_imports
- POST sdi.openapi.it/customer_invoice_imports
- GET sdi.openapi.it/invoices_stats
- PATCH sdi.openapi.it/business_registry_configurations
- POST sdi.openapi.it/invoices_signature
- POST sdi.openapi.it/invoices_legal_storage
- POST sdi.openapi.it/invoices_signature_legal_storage
- POST sdi.openapi.it/supplier_invoice_imports_legal_storage
- POST sdi.openapi.it/customer_invoice_imports_legal_storage
- POST sdi.openapi.it/simulate-supplier-invoice
-
Sandbox Scopes 20
- GET test.sdi.openapi.it/invoices
- POST test.sdi.openapi.it/invoices
- GET test.sdi.openapi.it/invoices_download
- POST test.sdi.openapi.it/business_registry_configurations
- POST test.sdi.openapi.it/api_configurations
- DELETE test.sdi.openapi.it/api_configurations
- GET test.sdi.openapi.it/api_configurations
- DELETE test.sdi.openapi.it/business_registry_configurations
- GET test.sdi.openapi.it/business_registry_configurations
- GET test.sdi.openapi.it/invoices_notifications
- POST test.sdi.openapi.it/supplier_invoice_imports
- POST test.sdi.openapi.it/customer_invoice_imports
- GET test.sdi.openapi.it/invoices_stats
- PATCH test.sdi.openapi.it/business_registry_configurations
- POST test.sdi.openapi.it/invoices_signature
- POST test.sdi.openapi.it/invoices_legal_storage
- POST test.sdi.openapi.it/invoices_signature_legal_storage
- POST test.sdi.openapi.it/supplier_invoice_imports_legal_storage
- POST test.sdi.openapi.it/customer_invoice_imports_legal_storage
- POST test.sdi.openapi.it/simulate