Invia scontrini elettronici e fatture all’Agenzia delle Entrate in modo semplice, veloce e altamente sicuro
Automatizza l’invio in tempo reale di documenti commerciali e fatture elettroniche tramite API, garantendo conformità normativa, affidabilità operativa e sicurezza.
Per configurare correttamente l’azienda ai fini della gestione della fatturazione elettronica B2B e verso la Pubblica Amministrazione, sono richiesti i seguenti dati:
- Identificativo fiscale dell’azienda (Codice Fiscale o Partita IVA)
- Ragione sociale
- Indirizzo email per l’invio di comunicazioni e notifiche (L’email indicata non potrà essere modificata dopo la creazione della configurazione.)
Durante la configurazione è inoltre necessario specificare come si intende utilizzare il servizio:
- Solo invio fatture attive (customer_invoice)
- Solo ricezione fatture passive (supplier_invoice)
- Gestione completa del ciclo di fatturazione (attivo e passivo)
Per abilitare le funzionalità desiderate è necessario impostare a true i relativi campi in fase di richiesta.
È possibile inoltre configurare le tipologie di eventi per cui si desidera ricevere notifiche.
Nota importante per la ricezione delle fatture passive
Per ricevere correttamente le fatture dai fornitori, non è sufficiente impostare il campo supplier_invoice a true. È necessario registrare il nostro Codice Destinatario (PIC7CPS) sul sito dell’Agenzia delle Entrate, così da associare correttamente il canale di ricezione.
Le informazioni necessarie sono:
- Codice Fiscale
- Nome Azienda
- Codice Fiscale
- Password
- PIN
Inoltre è necessario impostare in campo “receipts” a true.
I dati devono essere del soggetto responsabile dell’invio degli scontrini, quindi nel caso si stia sviluppando per terzi, devono essere del cliente finale.
E’ necessario aggiornare i dati di accesso trimestralmente perché l’Agenzia delle Entrate provvede a far scadere le credenziali.
In questa fase è possibile inoltre configurare anche le tipologie di eventi per cui ricevere le notifiche.
Sì. Con Openapi è possibile gestire, per la stessa azienda, sia l’intero ciclo di fatturazione elettronica B2B e verso la Pubblica Amministrazione, sia l’invio dei documenti commerciali (scontrini elettronici) all’Agenzia delle Entrate, utilizzando un’unica API.
In fase di configurazione è sufficiente impostare a true i campi dedicati:
- customer_invoice (fatture attive)
- supplier_invoice (fatture passive)
- receipts (documenti commerciali)
In questo modo sarà possibile abilitare tutte le funzionalità necessarie tramite un’unica integrazione.
Si è possibile attivare più aziende completando la procedura di configurazione tramite l’endpoint dedicato (Business Registry Configuration).
No, ma oltre le 10 configurazioni c’è costo pari a 1€.
Sì. Le fatture elettroniche destinate alla Pubblica Amministrazione vengono firmate automaticamente dal sistema prima dell’invio.
In fase di trasmissione è comunque possibile fornire le credenziali del proprio certificato, utilizzando il servizio EU-QES_automatic, nel caso si desideri applicare una firma digitale personalizzata.
In assenza di un certificato personalizzato, verrà applicata la firma digitale predefinita del servizio.
Sì, puoi importare lo storico delle fatture tramite l’endpoint POST /IT-invoices_import.
Sì. Tramite l’endpoint PATCH /IT-configuration è possibile aggiornare in qualsiasi momento diverse informazioni, tra cui:
- Attivazione o disattivazione del servizio di invio scontrini (receipts)
- Credenziali di autenticazione
- Tipologie di notifiche per eventi
Nota importante: non è possibile modificare l’email indicata durante la configurazione. È quindi fondamentale inserire fin da subito l’indirizzo corretto, poiché verrà utilizzato per tutte le comunicazioni e notifiche.
Il Codice Destinatario da impostare per la ricezione delle fatture è PIC7CPS
No. Se non hai bisogno di ricevere fatture passive, non è necessario registrare alcun codice destinatario.
E’ possibile configurare le notifiche per i seguenti eventi:
- receipt: quando una nuova ricevuta viene inviata e pronta
- ricevuta-credenziali: quando ci sono aggiornamenti sulle credenziali
- receipt-retry: quando la comunicazione con il portale dell'Agenzia delle Entrate non è andata a buon fine e si tenterà di inviare nuovamente la ricevuta
- appointee: quando il processo di assegnazione per le ricevute è riuscito
Il sistema archivia e rende disponibili le risposte relative agli invii, annullamenti e resi degli scontrini per 12 mesi. Trascorso questo periodo, i dati vengono automaticamente cancellati.
Il servizio invia in tempo reale gli scontrini elettronici, i tempi di risposta dipendono dall’Agenzia delle Entrate.
Il costo viene addebitato sia in caso di invio, di annullamento e di reso.
E’ previsto un costo di 1€ oltre le 10 configurazioni Business
Nella sezione Utilizzo, a livello di API, puoi monitorare tutte le richieste effettuate, sia gratuite sia tramite abbonamento o ricarica.
Sono disponibili due modalità di visualizzazione:
- Grafica: per periodi mensili o annuali.
- Riepilogo testuale: con dettaglio dei consumi.
Scontrino fiscale: a partire da 0,009 € con abbonamento o 0,019 € con addebito su credito.
Fatture elettroniche: a partire da 0,049 € con abbonamento o 0,154 € con addebito su credito.
Sì, puoi attivare un abbonamento annuale per ridurre il costo per singola chiamata, sia per gli scontrini elettronici sia per le fatture elettroniche.
Nella sezione Abbonamenti della singola API puoi:
- Visualizzare le opzioni disponibili con prezzi e percentuali di risparmio.
- Attivare l’abbonamento che preferisci direttamente dall’interfaccia.