Fatturazione elettronica facile, veloce e con alti standard di sicurezza
Automatizza l’invio, la firma, la ricezione e la conservazione digitale delle fatture elettroniche tramite API
Tutte le informazioni di cui hai bisogno
Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.
Utili consigli per iniziare con
Fatturazione Elettronica SDI
Prendi il token nell'apposita sezione prima di cominciare.
Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Configura l'azienda
Configurare l'azienda con /business_registry_configurations decidendo che tipi di opzioni tra fattura normale, fattura firmata e fattura firmata ed in conservazione. Se si è scelto di attivare la conservazione le credenziali verranno inviate all'indirizzo email indicato in fase di configurazione. Attenzione l'indirizzo email e la partita iva sono dati univoci. Questa operazione va eseguita solo quando si imposta l'azienda la prima volta.
Configura le notifiche per gestire approvazioni e scarti
Configurare le callback con /api_configurations impostando una o più tra queste opzioni se occorrono: 'supplier-invoice' (fattura passiva), 'customer-invoice' (fattura_attiva), 'customer-notification' (notifica di scarto o accettazione), 'legal-storage-missing-vat', 'legal-storage-receipt' (ricevuta di conservazione). In questo modo riceverai una chiamata con l'oggetto fattura direttamente all'url da te fornito.
Questa operazione va eseguita solo quando si imposta l'azienda la prima volta.
Se si è interessati al ciclo passivo seguire questa guida prima di tutto: https://openapi.it/en/blog/register-recipient-code-italian-revenue-agency.html
Questa operazione va eseguita solo quando si imposta l'azienda la prima volta.
Se si è interessati al ciclo passivo seguire questa guida prima di tutto: https://openapi.it/en/blog/register-recipient-code-italian-revenue-agency.html
Invia la prima fattura
Utilizzare gli endpoint
/invoices,
/invoices_signature,
/invoices_legal_storage o
/invoices_signature_legal_storage in base alla propria necessità. Essi permettono di inviare la fattura sia in modalità xml (compatibile con lo standard xml di fatturazione) che in modalità json.
Un volta inviata la fattura la notifica verrà reacpitata all'url indicato nella configurazione delle notifiche.
La risposta ad un invio di fattura conterrà un uuid che potrà essere successivamente usato per recuperare la fattura /invoices, eventuali notifiche /invoices_notifications o scaricare la fattura /invoices_download
Un volta inviata la fattura la notifica verrà reacpitata all'url indicato nella configurazione delle notifiche.
La risposta ad un invio di fattura conterrà un uuid che potrà essere successivamente usato per recuperare la fattura /invoices, eventuali notifiche /invoices_notifications o scaricare la fattura /invoices_download
- Oas file url https://console.openapi.com/oas/it/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