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 associazioni e cooperative, l’attivazione del servizio Scontrini avviene tramite una procedura guidata gestita dal nostro team di assistenza.
Per richiederne l’attivazione:
- Acquista il pacchetto Assistenza Premium (2 ore)
- Apri un ticket specificando la richiesta di attivazione del servizio Scontrini per Associazione/Cooperativa
Un nostro operatore ti ricontatterà nel più breve tempo possibile per completare la configurazione.
Durante la procedura sarà necessario fornire i dati del rappresentante legale. Inoltre, il rappresentante legale dovrà avere accesso al Cassetto Fiscale tramite le proprie credenziali (username e password), necessarie per completare correttamente l’attivazione del servizio.
Sì, il servizio supporta la gestione di più aziende. Per attivare la fatturazione su ciascuna impresa è sufficiente eseguire la procedura di configurazione dedicata tramite l'endpoint Business Registry Configuration, ripetendo l'operazione per ogni azienda che si desidera abilitare.
Una volta completata la configurazione, ogni azienda potrà utilizzare il servizio in modo indipendente con le proprie impostazioni di fatturazione.
No, ma oltre le 10 configurazioni c’è costo pari a 1€.
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.
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) registrata presso l'Agenzia delle Entrate italiana
- 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ì. 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
Per completare la configurazione, è possibile registrare questo codice direttamente nell’area dedicata del portale dell’Agenzia delle Entrate. Per maggiori dettagli, consulta la nostra guida di configurazione del codice destinatario.
No. Se non hai bisogno di ricevere fatture passive, non è necessario registrare alcun codice destinatario.
Sì, puoi importare lo storico delle fatture tramite l’endpoint POST /IT-invoices_import.
Sì, le fatture elettroniche destinate alla Pubblica Amministrazione vengono firmate automaticamente dal sistema prima dell’invio.
In alternativa, è possibile utilizzare un certificato di firma personalizzato attivando la firma qualificata automatica (QES Automatic) tramite Openapi attraverso l’apposito endpoint (POST /certificates/namirial-automatic). Una volta attivato, sarà necessario includere le credenziali del servizio nell’header della richiesta di invio delle fatture, così da consentire la firma con il certificato configurato.
Nel caso di utilizzo di una firma personalizzata, oltre al costo di attivazione del certificato verrà applicato un costo per singola firma a partire da €0,013 con piano in abbonamento oppure €0,045 con addebito tramite ricarica.
In assenza di un certificato personalizzato, verrà applicata automaticamente la firma digitale predefinita del servizio gratuitamente.
Le cause principali possono essere due:
- La configurazione non è stata completata correttamente.
- Non hai credito disponibile.
Per ricevere le fatture passive, è necessario:
- Effettuare la configurazione tramite POST /api_configurations.
- Impostare il valore "supplier_invoice" come indicato nella documentazione. In questo modo le fatture verranno inviate al callback specificato.
Successivamente, potrai recuperarle tramite GET /invoices.
IMPORTANTE: se il credito disponibile si esaurisce, le fatture passive smettono di essere recapitate.
Sì. Quando recuperi un singolo scontrino, puoi scaricarlo nella versione predefinita in JSON oppure in PDF. Per ottenere il PDF, basta impostare l’header Content-Type su "application/pdf".
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
- customer-invoice: quando si verifica qualsiasi cambio di stato delle fatture attive
- supplier-invoice: quando si verifica qualsiasi cambio di stato delle fatture passive
- receipt-error: quando l'AdE restituisce un errore per uno scontrino elettronico
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.