Fatturazione Elettronica SDI

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

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