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
Per poter implementare e utilizzare correttamente il servizio di fatturazione suggeriamo di seguire passo passo la documentazione.
Gli step fondamentali sono:
1: Creazione del proprio Business Registry Configuration attraverso POST /business_registry_configurations
Questo step è fondamentale per impostare e gestire i dati aziendali della propria azienda o aziende di clienti.
Attraverso la configurazione è possibile personalizzare alcune impostazioni, come l'opzione di firma e/o conservazione a norma.
ATTENZIONE: Dopo aver completato la configurazione si potrà utilizzare esclusivamente l’endpoint dell'opzione impostata.
2: Configurare gli endpoint di notifica tramite POST /api_configurations.
È importante inserire tutti gli eventi per i quali si desidera ricevere una notifica. Tutte le notifiche ricevute da SDI infatti saranno inviate agli endpoint configurati.
Sarà comunque possibile recuperare le notifiche con l'endpoint 'notification' passando l'uuid della fattura.
NOTA BENE: Questo step è fondamentale per la ricezione delle fatture passive. Sempre per la ricezione delle fatture passive, inoltre, è necessario registrare il nostro Codice Destinatario (JKKZDGR) sul sito dell'Agenzia delle Entrate.
3: Invio della fattura tramite POST /invoices
Questo endpoint consente di inviare fatture elettroniche in XML al Sistema di Interscambio (SdI) in tempo reale.
In questa fase va specificato esplicitamente il formato del corpo della richiesta con l'intestazione ‘content-type’. Una volta inviata, la fattura sarà immediatamente messa in coda per l'elaborazione e, se impostate, verranno notificate all'evento callback corrispondente le notifiche pertinenti.
Gli endpoint successivi a POST /invoices permettono inoltre di creare una fattura applicando la firma e/o la conservazione a norma.
Con Openapi è possibile poi importare le fatture attive e passive dei clienti o fornitori attraverso gli endpoint indicati sotto la voce ‘Import’ della documentazione:
- POST /supplier_invoice_imports
- POST /customer_invoice_imports
- POST /supplier_invoice_imports_legal_storage
- POST /customer_invoice_imports_legal_storage
Infine, è possibile simulare varie funzionalità della fatturazione elettronica (in ambiente Sandbox), attraverso l’endpoint POST /simulate-supplier-invoice.
L’API Fatturazione Elettronica permette di inviare fatture elettroniche in XML al sistema di interscambio (SdI) in tempo reale attraverso l’endpoint POST /invoices.
In particolare, è necessario esplicitare in fase di richiesta il formato utilizzando l'intestazione content-type. La fattura sarà messa in coda immediatamente e si otterrà l'UUID della fattura come callback.
È possibile attivare la fatturazione per l’invio a Sdi, con apposizione di firma elettronica e/o con Conservazione a Norma.
È possibile impostare le opzioni di fatturazione tramite l’endpoint POST /business_registry_configurations.
In particolare, con questa prima richiesta si può indicare se utilizzare le API esclusivamente per l'invio e la ricezione delle fatture o se attivare anche l'opzione di firma (apply_signature) e/o conservazione a norma (apply_legal_storage).
Una volta completata la configurazione, sarà possibile utilizzare esclusivamente l'endpoint dell'opzione impostata.
Il service consente, oltre all'invio, di apporre anche la firma elettronica sulla fattura elettronica XML attraverso l’endpoint POST /invoices_signature.
In questo modo verrà garantita l'integrità dei dati contenuti. Una fattura firmata ha una ‘robustezza’ legale maggiore rispetto ad un documento non firmato.
La firma è obbligatoria per fatture elettroniche verso la PA.
È possibile inviare e attivare via API la conservazione a norma per 10 anni sulle fatture elettroniche attive e passive attraverso l’endpoint POST /invoices_legal_storage.
La conservazione a norma è obbligatoria e garantisce autenticità, integrità, affidabilità, leggibilità e reperibilità alle fatture. La conservazione a norma disponibile tramite Openapi è compliant al regolamento eIDAS.
No, l’email inserita durante la configurazione non può essere modificata, per cui è molto importante in questa fase indicare l’email corretta.
Sì, puoi importare via API lo storico di fatture attive (attraverso l’endpoint POST /customer_invoice_imports) e passive (endpoint POST /supplier_invoice_imports).
Inoltre, è possibile inviare in Conservazione le fattura sia attive (tramite l’endpoint POST /customer_invoice_imports_legal_storage) sia passive (endpoint POST /supplier_invoice_imports_legal_storage).
Sì, attraverso l’endpoint POST /invoices_signature_legal_storage puoi effettuare l'intero processo di firma, invio a SDI e conservazione a norma con una sola richiesta.
Nella descrizione della fattura deve essere inserita la parola "euro", in caso contrario il sistema potrebbe richiedere una conferma manuale.
Sono due le possibili ragioni per cui non ricevi le fatture:
- non hai effettuato la configurazione
- non hai credito
Per ricevere le fatture è necessario infatti effettuare la configurazione tramite l'endpoint POST/api_configurations.
Nello specifico, è necessario impostare il valore "supplier-invoice" - come indicato nella documentazione - e le fatture verranno inviate al callback specificato.
Potrai poi recuperare le fatture attraverso GET/invoices.
IMPORTANTE: se il credito si esaurisce le fatture passive smettono di essere recapitate.
Se il cliente è un soggetto privato il codice SdI è sempre “0000000” (sette volte zero).
Il Codice Destinatario da impostare è JKKZDGR.
No, se uno non ha bisogno di ricevere fatture passive non è tenuto a registrare il codice destinatario.
No, non è richiesta un'implementazione tecnica specifica, è però necessario richiederci, con apertura di ticket, l'inserimento del vostro dominio nella nostra whitelist per motivi di sicurezza.
Se il tuo account è stato sospeso per credito insufficiente, puoi riattivarlo inviando una richiesta a PATCH /business_registry_configurations/{fiscal_id}/activate.
NOTA BENE: Non appena il tuo account viene sospeso, ricevi anche un'e-mail di promemoria con le istruzioni per riattivarlo, per cui ti suggeriamo di tenere monitorata la tua casella di posta.
Il servizio restituisce la risposta in tempo reale.
Il costo dell’invio della fattura a SdI è a partire da 0,025€ su abbonamento, 0,07€ per richiesta singola.
Il costo della Conservazione a Conservazione a Norma è 0,035€, mentre della Firma Fattura Elettronica è pari a 0,02€.
Sì, è possibile attivare l’abbonamento annuale, e risparmiare quindi sul costo della singola chiamata.
Nella sezione Abbonamenti della singola API puoi vedere le opzioni disponibili (con i relativi prezzi e la percentuale di risparmio) e puoi anche attivare l’abbonamento che preferisci.
Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite abbonamento o ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.