API

importa_fattura

Chiamata POST: https://easy.fatt.cloud/crossWebAPI.svc/importa_fattura

Parametri da inviare via POST

Tokenstring (obbligatorio)ApiKey oppure il token ritornato dall'API "auth"
FileNamestring (obbligatorio)Nome del file XML
FileBase64string (obbligatorio)Contenuto del file XML in formato Base64

Viene ritornato il seguente oggetto JSON

ErrorstringEventuale messaggio d'errore se l'importazione non dovesse andasse a buon fine
Resultstring(Sempre stringa vuota)

fatture

Chiamata POST: https://easy.fatt.cloud/crossWebAPI.svc/fatture

Parametri da inviare via POST

Tokenstring (obbligatorio)ApiKey oppure il token ritornato dall'API "auth"
Annoint (obbligatorio)Anno di riferimento
PIVAstring (obbligatorio)P.IVA dell'azienda che ha emesso le fatture da ricercare
Ritornoint (obbligatorio)Valori consentiti:
0 -> ritorna solo lo stato delle fatture
1 -> ritorna le fatture attive
2 -> ritorna le fatture passive
3 -> ritorna le notifiche
4 -> ritorna le fatture attive e le notifiche
PageNumintNumero di pagina. Valore di default: 1
PageSizeintNumero di fatture contenute in una pagina. Valore di default: 100. Valore massimo 1000
DaDataFattstringFiltro sulla data fattura. Formato: aaaa-mm-gg
ADataFattstringFiltro sulla data fattura. Formato: aaaa-mm-gg
DaDataInsstringFiltro sulla data inserimento. Formato: aaaa-mm-gg
ADataInsstringFiltro sulla data inserimento. Formato: aaaa-mm-gg
DaDataUpdstringFiltro sulla data ultimo aggiornamento. Formato: aaaa-mm-gg
ADataUpdstringFiltro sulla data ultimo aggiornamento. Formato: aaaa-mm-gg
ADataUpdstringFiltro sulla data ultimo aggiornamento. Formato: aaaa-mm-gg
StatoInviostringVengono ritornate solo le fatture in un certo stato, ad esempio tutte le scartate, oppure quelle non consegnate. Per i valori possibili vedere più sotto
PIVAClistringVengono ritornate solo le fatture fatte ad un certo cliente
CodFiscClistringVengono ritornate solo le fatture fatte ad un certo cliente
XMLsstringLista di nomi di file XML separati da virgola. Vengono ritornate solo le fatture con i nomi specificati in questa lista

Viene ritornato il seguente oggetto JSON

ErrorstringEventuale messaggio d'errore se l'importazione non dovesse andasse a buon fine
ResultList<FatturaXML>Array contenente la lista delle fatture che corrispondono ai criteri specificati. La dimensione massima dell'array è "PageSize"
CountstringNumero di fatture totali trovate che corrispondono ai criteri specificati (Potrebbe essere maggiore di PageSize)

Segue l'oggetto JSON "FatturaXML"

StatoInviostringStato attuale della fattura. Valori possibili:
"Scartata"
"Inviata" = Inviata al SDI e non è stata ricevuta ancora alcuna notifica
"In preparazione" o "Da inviare" = Non ancora inviata al SDI
"Inoltrata" = ricevuta solo la notitifca di corretto recapito al cassetto fiscale
"Consegnata" = consegnata al destinatario
"Non consegnata" = recapitata nel cassetto fiscale, ma non consegnata via PEC o via codice destinatario
"Errore invio"
"Errore nell'XML"
"Accettata" - valido solo per le fatture inviate alla PA
"Rifiutata" - valido solo per le fatture inviate alla PA
"Decorrenza termini" - valido solo per le fatture inviate alla PA
NomeFatturastringNome del file XML della fattura (sempre valorizzato)
FatturaBase64stringFile XML della fattura in formato Base64 (valorizzato se Ritorno è 1, 2 o 4)
NomeNotificastringNome del file XML dell'ultima notifica ricevuta (valorizzato se Ritorno è 3 o 4)
NotificaBase64stringFile XML dell'ultima notifica ricevuta in formato Base64 (valorizzato se Ritorno è 3 o 4)