Version: 1.0

EPortale REST API

API REST per la gestione di fatture elettroniche e corrispettivi.

Tutte le chiamate avvengono verso https://eportale.eu/angular/rest e richiedono autenticazione tramite Bearer token ottenuto dall'endpoint di login. Il token va incluso nell'header Authorization: Bearer <token> per le chiamate successive.

Autenticazione

Metodo	Endpoint	Descrizione
POST	/auth/login	Autentica l'utente e restituisce i dati della sessione
GET	/auth/whoami	Restituisce l'id utente dal Bearer token
POST	/auth/cambiaPasswordAde	Aggiorna le credenziali Agenzia delle Entrate
POST	/auth/verificaCredenzialiAde	Verifica la validità delle credenziali AdE

Fattura Elettronica

Consultazione

Metodo	Endpoint	Descrizione
POST	/fatturaElettronica/getFeInviate	Elenco delle fatture elettroniche inviate allo SDI
POST	/fatturaElettronica/getFeRicevute	Elenco delle fatture elettroniche ricevute
POST	/fatturaElettronica/getFeConsegnate	Elenco delle fatture consegnate
POST	/fatturaElettronica/getFattureScartateNonReinviate	Fatture scartate dallo SDI e non ancora reinviate
POST	/fatturaElettronica/getDocIdentificativoSdi	Recupera documento tramite identificativo SDI
POST	/fatturaElettronica/getDocNomeFile	Recupera documento tramite nome file
POST	/fatturaElettronica/getMetadato	Restituisce i metadati della fattura
POST	/fatturaElettronica/getNotifica	Restituisce la notifica associata alla fattura
POST	/fatturaElettronica/getNotificheList	Elenco delle notifiche
POST	/fatturaElettronica/getUltimaNotificaList	Ultima notifica disponibile per ciascuna fattura
POST	/fatturaElettronica/getOrdiniNsoRicevuti	Ordini NSO ricevuti

Import e utilità

Metodo	Endpoint	Descrizione
POST	/fatturaElettronica/importFeAttivo	Importa una fattura elettronica attiva
POST	/fatturaElettronica/importFePassivo	Importa una fattura elettronica passiva
POST	/fatturaElettronica/checkFe	Valida una fattura elettronica
POST	/fatturaElettronica/getPdfFromXml	Genera PDF leggibile dall'XML della fattura
POST	/fatturaElettronica/getXmlFromP7m	Estrae l'XML da un file P7M firmato
POST	/fatturaElettronica/resetDownloadFlag	Resetta il flag di download della fattura

Corrispettivo Elettronico

Metodo	Endpoint	Descrizione
POST	/corrispettivoElettronico/inviaCorrispettivo	Trasmette un corrispettivo elettronico all'Agenzia delle Entrate
POST	/corrispettivoElettronico/annullaCorrispettivo	Annulla un corrispettivo precedentemente inviato
POST	/corrispettivoElettronico/listaCorrispettivo	Elenco dei corrispettivi trasmessi

Note di compilazione

Campo	Note
pagamento	Tipo di pagamento del documento commerciale: PE Pagamento Elettronico, PC Pagamento Contante.
tipoDoc	Per la chiamata inviaCorrispettivo il campo non deve essere compilato.
tipoTrasmissione	1: da utilizzare se si desidera trasmettere il documento commerciale compilando l'oggetto CorrispettivoTestataItem. 2: da utilizzare se si desidera trasmettere il documento commerciale tramite byte array, valorizzando il campo tracciato.
aliquotaIva	Il valore deve essere indicato senza il simbolo di percentuale. Ad esempio, per un'aliquota del 10% il valore da trasmettere è 10.
utenteAdeItem	Il campo deve essere compilato utilizzando le credenziali dell'Agenzia delle Entrate.
corrispettivoRigaItemList	La lista contenente le righe dello scontrino è obbligatoria.

Attenzione

L'Agenzia delle Entrate non mette a disposizione un ambiente di test. Si consiglia pertanto di effettuare l'invio di uno scontrino di importo minimo. L'integrazione può essere considerata correttamente funzionante una volta ottenuto il progressivo restituito dall'AdE; successivamente sarà possibile procedere con l'annullamento dello scontrino trasmesso.

Conservazione Sostitutiva

Metodo	Endpoint	Descrizione
POST	/conservazione/conservaFeInviate	Avvia la conservazione di una fattura elettronica attiva
POST	/conservazione/conservaFeRicevute	Avvia la conservazione di una fattura elettronica passiva

Azienda e Pacchetti

Metodo	Endpoint	Descrizione
POST	/azienda/getAzienda	Restituisce i dati dell'azienda associata all'utente
POST	/pacchetti/getPacchettiAttivi	Elenco dei pacchetti servizio attivi sull'account

La documentazione dei servizi REST non è ancora completamente allineata. Per il dettaglio dei campi richiesti si può fare riferimento alla documentazione dei servizi SOAP.

Contact

undefined