Fattura Elettronica Sicura - trusttechnologies.it · Per l’approfondimento di ome eseritare...

MANUALE DI INTEGRAZIONE

revisione 2.4

15 Febbraio 2018

Fattura Elettronica Sicura

______________________________________________________________________________ Pagina 1 TI TRUST TECHNOLOGIES – Documento Pubblico – Tutti i diritti riservati

1. INDICE

Sommario

1. INDICE ........................................................................................................................................................ 1

2. RIFERIMENTI .............................................................................................................................................. 4

Formato Fattura Elettronica .............................................................................................................. 4 2.1

Sistema di Interscambio - SDI ............................................................................................................ 4 2.2

Intermediari ....................................................................................................................................... 4 2.3

3. MODELLO SINTETICO DI INTERAZIONE ..................................................................................................... 5

4. PROCESSO E INTEGRAZIONE APPLICATIVA ................................................................................................ 6

Gestione delle Fatture Elettroniche del CICLO ATTIVO ..................................................................... 6 4.1

Alert ................................................................................................................................................... 6 4.2

Cruscotto Fatture Trasmesse/Conservate ......................................................................................... 6 4.3

Download e Gestione delle Fatture Elettroniche del CICLO PASSIVO ............................................... 6 4.4

5. CREDENZIALI E PORTALE ........................................................................................................................... 7

6. FATTURE ELETTRONICHE CICLO ATTIVO .................................................................................................... 8

Caso d’uso .......................................................................................................................................... 8 6.1

Uploadfattura: Sito di Test ................................................................................................................ 8 6.2

Uploadfattura: Sito di Produzione ..................................................................................................... 8 6.3

Uploadfattura: Autenticazione al Servizio ......................................................................................... 9 6.4

Uploadfattura: Parametri di Input del Servizio ................................................................................. 9 6.5

Uploadfattura:Esempio di chiamata al Servizio ................................................................................ 9 6.6

Uploadfattura: Response del Servizio ............................................................................................... 9 6.7

Formato della Response .......................................................................................................... 10 6.7.1

Mappatura degli errori ............................................................................................................ 10 6.7.2

Esempio per la gestione della Response ................................................................................. 10 6.7.3

exportDocuments: Sito di Test ........................................................................................................ 11 6.8

exportDocuments: Sito di Produzione ............................................................................................. 11 6.9

exportDocuments: Autenticazione al Servizio................................................................................. 11 6.10

exportDocuments: Esempio di chiamata HTTPS al Servizio ............................................................ 11 6.11

exportDocuments: Response del Servizio ....................................................................................... 12 6.12

Formato della Response: ......................................................................................................... 12 6.12.1

Proprietà delle Fatture Elettroniche Attive ............................................................................. 12 6.12.2


Mappatura degli Errori ............................................................................................................ 12 6.12.3

Esempio di Response: .............................................................................................................. 12 6.12.4

updateDocuments: Sito di Test ....................................................................................................... 13 6.13

updateDocuments: Sito di Produzione ............................................................................................ 13 6.14

updateDocuments: Autenticazione al Servizio ................................................................................ 13 6.15

updateDocuments: Parametri di Input del Servizio ........................................................................ 13 6.16

Proprietà chiave per l’identificazione della fattura ................................................................. 14 6.16.1

Proprietà da aggiornare ........................................................................................................... 14 6.16.2

updateDocuments: Esempio di chiamata HTTPS al Servizio ........................................................... 14 6.17

updateDocuments: Response .......................................................................................................... 15 6.18



Esempio di Response contenente errori ................................................................................. 16 6.18.3

Esempio di Response in assenza di errori ................................................................................ 16 6.18.4

Fattura esemplificativa per Test ...................................................................................................... 16 6.19

7. FATTURE ELETTRONICHE CICLO PASSIVO ................................................................................................ 21

Caso d’uso ........................................................................................................................................ 21 7.1

exportDocuments: Sito di Test ........................................................................................................ 21 7.2

exportDocuments: Sito di Produzione ............................................................................................. 21 7.3

exportDocuments: Autenticazione al Servizio................................................................................. 22 7.4

exportDocuments: Esempio di chiamata HTTPS al Servizio ............................................................ 22 7.5

exportDocuments: Response del Servizio ....................................................................................... 22 7.6

Formato della Response: ......................................................................................................... 22 7.6.1

Proprietà delle Fatture Elettroniche Fornitori restituite ......................................................... 23 7.6.2


Esempio di Response: .............................................................................................................. 23 7.6.4

8. NOTIFICA DI RIFIUTO/ACCETTAZIONE ..................................................................................................... 24

Caso d’uso ........................................................................................................................................ 24 8.1

updateDocuments: Sito di Test ....................................................................................................... 24 8.2

updateDocuments: Sito di Produzione ............................................................................................ 24 8.3

updateDocuments: Autenticazione al Servizio ................................................................................ 24 8.4

updateDocuments: Parametri di Input del Servizio ........................................................................ 25 8.5

Proprietà chiave per l’identificazione della fattura ................................................................. 25 8.5.1

Proprietà da aggiornare ........................................................................................................... 25 8.5.2

updateDocuments: Esempio di chiamata HTTPS al Servizio ........................................................... 25 8.6

updateDocuments: Response .......................................................................................................... 26 8.7




Esempio di Response contenente errori ................................................................................. 27 8.7.3

Esempio di Response in assenza di errori ................................................................................ 27 8.7.4

9. INFO E ASSISTENZA IN PRODUZIONE....................................................................................................... 27


2. RIFERIMENTI

Formato Fattura Elettronica 2.1

Tutto sulla Fatturazione Elettronica sia verso la P.A. che verso le Aziende Private, in particolare per approfondire i temi:

- Schema del file xml FatturaPA versione 1.2 - Specifiche tecniche del formato della FatturaPA versione 1.2 - Rappresentazione tabellare del tracciato FatturaPA versione 1.2

www.fatturaelettronicapa.gov.it

Sistema di Interscambio - SDI 2.2

Tutto sul Sistema di Interscambio, in particolare per approfondire i temi:

- Specifiche tecniche relative al Sistema di Interscambio versione 1.4 - Elenco controlli versione 1.4

http://fatturapa.gov.it/export/fatturazione/it/sdi.htm

Intermediari 2.3

Trust Techhnologies agisce come “Intermediario”. Ecco dove potete trovare tutte le informazioni sugli INTERMEDIARI ed il loro ruolo a termini di legge:

http://fatturapa.gov.it/export/fatturazione/it/c-3.htm

http://www.fatturaelettronicapa.gov.it/






3. MODELLO SINTETICO DI INTERAZIONE

Al fine di chiarire quali attività vengono prese in carico dalla soluzione FATTURA ELETTRONICA SICURA e quali sono a carico della applicazione, si propone di seguito un modello sintetico. L’interfaccia applicativa, con i servizi esposti che permettono di implementare l’interazione nell’immagine, è descritta nei capitoli seguenti.

In via prioritaria si ritiene di maggiore interesse per l’integratore fornire all’utente attraverso la propria applicazione tutte le informazioni di cui necessita. Ma in caso di necessità, l’utente può ricavare tutte le informazioni anche attraverso l’interfaccia web della soluzione.

L’unica attività che l’utente può fare solo con l’interfaccia web è la richiesta del Pacchetto di Esibizione.

Tra le informazioni che vengono fornite sulla fattura tramite l’interfaccia applicativa c’è anche la conferma del versamento nel Sistema di Conservazione ed il lotto corrispondente. Queste informazioni rendono del tutto privo di interesse l’accesso al Sistema di Conservazione per la visualizzazione delle fatture conservate, anche se è possibile.

Quello che invece è importante è che, in caso di richiesta della Autorità competente (es. Guardia di Finanza), è prevista la possibilità per l’utente tramite interfaccia web di richiedere il Pacchetto di Esibizione che sarà rilasciato nel formato previsto dalla normativa.

Poiché il Sistema di Conservazione non è un ambiente documentale, ma un repository legale, le credenziali per la richiesta del Pacchetto di Esibizione vengono di norma fornite dall’Help Desk di Fattura Elettronica Sicura nel momento in cui questa attività sarà necessaria, insieme alle relative istruzioni.


4. PROCESSO E INTEGRAZIONE APPLICATIVA La soluzione FATTURA ELETTRONICA SICURA è una soluzione web completa per la gestione della fatturazione elettronica, ed in particolare espone dei Web Services che consentono di gestire in modo applicativo alcune funzionalità.

Gestione delle Fatture Elettroniche del CICLO ATTIVO 4.1

Un primo Servizio (Uploadfattura) consente di caricare una o più fatture in modo applicativo. Una volta caricate, le fatture vengono firmate digitalmente con un certificato di Trust Technologies, trasmesse a SDI e versate automaticamente nel Sistema di Conservazione a Norma, dove vengono conservate, nell’ambito del periodo di vigenza contrattuale, fino alla scadenza prevista dalla normativa Fiscale e Civilistica. Firmando le fatture con un proprio certificato, Trust Technologies le “emette” a norma di legge per conto del cliente apparendo come “Terzo Intermediario”. Un secondo servizio (exportDocuments) consente di verificare lo stato della fattura in riferimento alle notifiche progressivamente pervenute da SDI. Un terzo ed ultimo Servizio (udateDocuments) consente di limitare la verifica dello stato della fattura alle fatture per le quali si ha un reale interesse.

Alert 4.2

La soluzione FATTURA ELETTRONICA SICURA gestisce tutto lo scambio di notifiche con SDI e, in caso di rigetto da parte di SDI o di rifiuto da parte del cliente, informa il Cedente/Prestatore con un messaggio via e-mail. L’indirizzo di e-mail al quale vengono inviati gli alert è quello indicato nella scheda tecnica di attivazione. L’indirizzo di posta elettronica si può modificare semplicemente chiamando l’Help Desk. Sono previsti solo alert di tipo negativo, per non gravare con comunicazioni inutili.

Cruscotto Fatture Trasmesse/Conservate 4.3

Nella fase di attivazione vengono inviate, al cliente che ha richiesto il servizio, le credenziali e l’indirizzo web di accesso al servizio. Accedendo potrà visualizzare ogni fattura e tutte le notifiche che sono state scambiate con lo SDI, ivi compresa la data di decorrenza dei termini. Potrà inoltre avere la conferma dell’avvenuto versamento nel Sistema di Conservazione.

Le stesse credenziali potranno essere utilizzate per l’accesso applicativo ai Servizi Esposti e descritti in questo documento.

Download e Gestione delle Fatture Elettroniche del CICLO PASSIVO 4.4

Le Fatture Elettroniche del Ciclo Passivo vengono inviate allo SDI dai fornitori che hanno scelto questa opzione, e dallo SDI inoltrate al Destinatario. Il Destinatario le può ricevere sulla propria PEC, su una PEC ad hoc da riservarsi alle sole Fatture, oppure su un proprio “Codice Destinatario”.

Per l’approfondimento di come esercitare queste opzioni attraverso la soluzione FATTURA ELETTRONICA SICURA, rimandiamo al Manuale Utente della soluzione. In ogni caso, la soluzione FATTURA ELETTRONICA SICURA carica automaticamente le Fatture Elettroniche del Ciclo Passivo su uno specifico Portale per consentirne la conservazione e consultazione.

Il cliente può interagire in modo applicativo con questo portale per gestire le Fatture con il proprio gestionale (registrarle, accettarle o rifiutarle).

A questo scopo è messo a disposizione il servizio exportDocuments, già descritto al paragrafo 4.1, ma utilizzato per questa finalità in modo diverso.

Dopo essere state Accettate (e registrate sul proprio gestionale), oppure Rifiutate, tale esito deve essere inoltrato a SDI e le Fatture accettate devono essere inviate automaticamente al Sistema di Conservazione a Norma di Trust Technologies.

A questo scopo è messo a disposizione il servizio updateDocuments.


5. CREDENZIALI E PORTALE

Per l’accesso ai metodi è necessaria una autenticazione (username, password) da impostare nell’header del client che richiama il webservice. Per ogni servizio viene nel seguito fornita la URL. Sono messi a disposizione siti di test per testare l’integrazione.

Le Credenziali ed il “Nome Sito” da usare in Collaudo verranno comunicate facendone richiesta all’indirizzo di posta Help Desk Fattura Elettronica Sicura. La richiesta dovrà essere preventivamente validata dal Marketing di Trust Technologies.

Le Credenziali ed i “Nome Sito” da usare in Produzione sono quelli che vengono inviate al cliente in fase di attivazione del Servizio; le credenziali si possono modificare con l’apposita funzionalità sul portale:

https://trustdoc.trusttechnologies.it

in particolare:

si debbono modificare al primo accesso

si debbono modificare alla scadenza indicata.

Il client deve quindi prevedere la possibilità per l’utente di reinserirle in qualsiasi momento.

Sullo stesso portale, sono disponibili le opzioni RACCOLTA DOCUMENTI e RICERCA AVANZATA per visualizzare (scaricare, stampare, ecc.) tutte le fatture prese in carico e le relative notifiche con lo SDI e informazioni sul versamento nel Sistema di Conservazione a Norma.

Sempre sulla home page, si può visualizzare o scaricare il MANUALE UTENTE che fornisce tutte le istruzioni per l’operatività sul portale.

mailto:[email protected]

https://trustdoc.trusttechnologies.it/


6. FATTURE ELETTRONICHE CICLO ATTIVO

Caso d’uso 6.1

Il servizio “Uploadfattura” consente di trasmettere attraverso il Sistema di interscambio (SDI) fatture già nel formato FatturaPA e di archiviarle nel documentale integrato TrustDoc e, sempre in modo automatico, nel Sistema di Conservazione a Norma (già “Conservazione Sostitutiva”).

Tali fatture sono immediatamente archiviate nello stato “In attesa di risposta da SDI” utilizzando le informazioni estratte dalla fattura stessa (data fattura, numero fattura, destinatario, ecc). Dal momento dell’invio inizia un periodo di al massimo 16 giorni in cui lo stato della fattura cambierà in funzione delle notifiche che lo SDI consegna al sistema che ha inviato le fatture. In particolare, dopo qualche ora, si riceverà in alternativa una notifica di consegna o una notifica di scarto, che farà assumere alla fattura rispettivamente lo stato di “Consegnata” o “Scartata da SDI”. Nel caso di una notifica di scarto la fattura conclude il proprio ciclo, nel caso di consegna invece la fattura potrà assumere alternativamente tre stati finali: “Accettata”, “Rifiutata”, “Decorrenza Termini”. L’accettazione o il rifiuto sono determinati da una azione del destinatario della fattura che deve essere intrapresa entro quindici giorni dall’avvenuta consegna. Scaduti i quindici giorni senza che il destinatario abbia inviato il proprio esito (detto “esito committente”) lo SDI invierà automaticamente una notifica di “Decorrenza termini”.

Per conoscere lo stato corrente delle fatture inviate ed aggiornare il proprio sistema contabile, è possibile utilizzare il servizio “exportDocuments”.

Dal risultato di una successiva chiamata del servizio sarà necessario escludere tutte le fatture che abbiano raggiunto uno stato finale, e cioè “Scartata da SDI, Accettata, Rifiutata, Decorrenza termini”. Per questo è possibile utilizzare il servizio “updateDocuments” settando l’indice “olv:escludi” al valore “TRUE”.

Uploadfattura: Sito di Test 6.2

La URL del servizio è: https://trustdoc.trusttechnologies.it/FatturaDigitale/app/fattura/uploadfattureTest

Le credenziali da utilizzare sono quelle comunicate dall’Help Desk Fattura Elettronica Sicura.

L’ambiente di test dà la possibilità di verificare l’avvenuto caricamento della fattura. La fattura viene firmata digitalmente ed inviata a SDI. Perché la Fattura non sia presa in carico da SDI, suggeriamo di inserire nel CODICE DESTINATARIO un valore non corretto, per esempio: “XXX”. In questo modo SDI rigetterà immediatamente la Fattura. Si potrà poi verificare, sul portale, accedendo in modalità web, che la fattura è stata correttamente caricata con i metadati indicati.

NOTA BENE: occorre concordare i test con l’HELP DESK di FATTURA ELETTRONICA SICURA, inviando una email di richiesta all’indirizzo di posta: Help Desk Fattura Elettronica Sicura.

Uploadfattura: Sito di Produzione 6.3

La URL del servizio è:

https://trustdoc.trusttechnologies.it/FatturaDigitale/app/fattura/uploadfattureProd

Le credenziali vengono fornite al richiedente all’attivazione del servizio.

Attenzione: non usare l’ambiente di produzione per fare delle prove; tutte le fatture inserite saranno inviate tramite SDI alla Agenzia delle Entrate. Trust Technologies declina qualsiasi responsabilità in merito al non corretto utilizzo dell’ambiente di produzione.

https://trustdoc.trusttechnologies.it/FatturaDigitale/app/fattura/uploadfatture


https://trustdoc.trusttechnologies.it/FatturaDigitale/app/fattura/uploadfattureProd


Uploadfattura: Autenticazione al Servizio 6.4

Il servizio deve essere autenticato mediante basic authentication. Un esempio di basic authentication e' possibile attraverso il Credential Provider di Apache (da inserire prima dell'execute della chiamata):

CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); credentialsProvider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials("user:pass")); HttpClientContext localContext = HttpClientContext.create(); localContext.setCredentialsProvider(credentialsProvider)

Si consiglia di codificare in base64 le stringhe username e password attraverso le librerie Apache di Java.

Uploadfattura: Parametri di Input del Servizio 6.5

Il Metodo UPLOADFATTURA consente di inviare una fattura verso la piattaforma di Fattura Elettronica di Trust Technologies. I parametri di Input sono:

byte[] filetosend: file fattura da inviare alla PA. Il file deve essere passato in base64Binary, secondo le specifiche W3C.

Uploadfattura:Esempio di chiamata al Servizio 6.6

Si riporta di seguito un esempio di client da poter utilizzare per accedere al servizio:

public void callRest() throws Exception { String url = "http://hdogold.test.olivetti.com/FatturaDigitale/app/fattura/Uploadfattura"; CloseableHttpClient client = HttpClients.createDefault(); HttpPost post = new HttpPost(url); byte [] bytes= FileUtils.readFileToByteArray(new File("D:/fatturazione-elettronica/FatturadiTest.xml")); MultipartEntityBuilder builder = MultipartEntityBuilder.create(); builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE); builder.addBinaryBody("filetosend", Base64.encodeBase64(bytes), ContentType.DEFAULT_BINARY, null); HttpEntity entity = builder.build(); post.setEntity(entity); HttpResponse response = client.execute(post); client.close(); }

Uploadfattura: Response del Servizio 6.7


Formato della Response 6.7.1

L’interpretazione dell’esito della chiamata è fruibile attraverso una Response che ha la seguente struttura:

returnCode: codice di ritorno. Se diverso da 0000 significa che si è verificato un errore

description: descrizione dell'errore in caso returnCode sia diverso da 0000

message: corrisponde all’uploadfilename; nome del file contenente la fattura elettronica che l'Intermediario ha comunicato a SdI. Il naming delle fatture elettroniche.

Mappatura degli errori 6.7.2

Errore http 401: Autenticazione negata; raccomandiamo di gestire questa evenienza, che si può tipicamente presentare nel momento in cui, per motivi di sicurezza, scadono le credenziali di accesso alla piattaforma. Codici di errore che può assumere il returnCode:

0001: Formato fattura non supportato 0002: Errore generico sul formato della fattura 0003: Inserimento non riuscito 0004: Errore nella produzione del File Fattura da inviare a SDI (verificare il corretto formato della Fattura)

Esempio per la gestione della Response 6.7.3

Esempio di classe per la gestione della response:

public class ReturnUploadValues { Integer returnCode; String description; String message; public ReturnUploadValues(Integer returnCode, String description, String message) { super(); this.returnCode = returnCode; this.description = description; this.message = message; } public Integer getReturnCode() { return returnCode; } public void setReturnCode(Integer returnCode) { this.returnCode = returnCode; } public String getDescription() { return description; } public void setDescription(String description) { this.description = description; } public String getMessage() { return message; } public void setMessage(String uploadFilename) { this.message = message; } }


exportDocuments: Sito di Test 6.8

La URL è: https://trustdoc.trusttechnologies.it/proxyTrustDoc/exportDocuments


NOTA BENE: Il momento temporale per il test di questa funzionalità deve essere concordato con l’HELP DESK di FATTURA ELETTRONICA SICURA, inviando una email di richiesta all’indirizzo di posta: Help Desk Fattura Elettronica Sicura. Nell’ambiente di Test, previo accordo con l’Help Desk, saranno inserite fatture nello stato “In attesa di riposta d SDI” che è possibile scaricare e modificare.

exportDocuments: Sito di Produzione 6.9


Le credenziali ed il nome del sito vengono fornite al richiedente all’attivazione del servizio.

Attenzione: non usare l’ambiente di produzione per fare delle prove.

exportDocuments: Autenticazione al Servizio 6.10

L'accesso ai servizi avverrà tramite Basic Authentication. Il Client invierà le credenziali d'accesso utilizzando l'header HTTP "Authorization" con la stringa "username:password" codificata in Base64.

Si riporta di seguito un possibile esempio di chiamata con parametri di autenticazione nell’header della richiesta:

POST /proxyTrustDoc/exportDocuments HTTP/1.1 Host: trustdoc.trusttechnologies.it Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

In caso di autenticazione non riuscita verrà restituito un errore http 401: raccomandiamo di gestire questa

evenienza, che si può tipicamente presentare nel momento in cui, per motivi di sicurezza, scadono le

credenziali di accesso alla piattaforma.

exportDocuments: Esempio di chiamata HTTPS al Servizio 6.11

L’integrazione avviene attraverso una chiamata HTTPS al servizio con le seguenti caratteristiche:

URL: https://trustdoc.trusttechnologies.it/proxyTrustDoc/exportDocuments Method: POST JSON Request (parametri della richiesta) {

"site":"<Nome Sito>", "class":"<Nome Classe documentale>", “xmlFile”: < true|false >

}

N.B.: l’istruzione "site":"<Nome Sito >" può essere tralasciata se il cliente gestisce una sola ragione sociale. Se gestisce più di una ragione sociale, deve avere acquistata l’opzione “ULTERIORI RAGIONI SOCIALI”.

Si riporta di seguito un possibile esempio di JSON Request coerente col caso d’uso:

{ "site":"Collaudo", "class":"olv:fatCliSDI", "xmlFile":"false" }

https://trustdoc.trusttechnologies.it/proxyTrustDoc/exportDocuments



https://trustdoc.trusttechnologies.it/proxyTrustDoc/



exportDocuments: Response del Servizio 6.12

Formato della Response: 6.12.1

{ “returnCode": "<codice esito operazione>", "description": "<descrizione in caso di esito negativo>

“message”: “<json array contenente l’elenco delle proprietà estratte in forma di coppia chiave:valore per le fatture con olv:escludi=False>” } In particolare l’informazione sullo Stato della Fattura si desume dalla proprietà “olv:fatCliSDIStato” della Fattura Elettronica (come evidenziato in giallo nella tabella del capitolo seguente).

Proprietà delle Fatture Elettroniche Attive 6.12.2

Le proprietà della classe documentale Fatture Elettroniche Attive (olv:fatCliSDI) applicabili al caso d’Uso e restituite sono:

olv:fatCliSDISezionale Codice identificativo univoco del registro in cui la fattura è registrata

Stringa

olv:fatCliSDINumFattura Numero della fattura Stringa

olv:fatCliSDIDataFattura Data di emissione della fattura attiva gg/mm/aaaa

olv:fatCliSDICodDestinatario Codice univoco del destinatario assegnato da SDI o indirizzo PEC

Stringa

olv:fatCliSDIStato Codice Stato della fattura

Possibili valori:

HDO00 = In attesa di risposta da SDI,

HDO01 = Accettata,

HDO02 = Rifiutata,

HDO03 = Decorrenza termini

HDO05 = Consegnata

HDO07 = Scartata olv:fatCliSDIId Numero attribuito dal Sistema di

Interscambio al file spedito Stringa di 7 cifre

cm:name Nome del fattura Stringa

Mappatura degli Errori 6.12.3

Il parametro "returnCode" della Response potrà assumere i seguenti valori:

0000 : success

1111 : nessun documento.

0100 : generic error;

Esempio di Response: 6.12.4

{ "returnCode":"0000", "description":"", "message": [ { "metadata": [ {"olv:fatCliSDISezionale":"A"}, {"olv:fatCliSDINumFattura":"835"}, {"olv:fatCliSDIDataFattura":"30/10/2017"}, {"olv:fatCliSDICodDestinatario":"F1GI42"}, {"olv:fatCliSDIStato":"HDO00"}, {"olv:fatCliSDIId":"9384527"}


] }, { "metadata": [ {"olv:fatCliSDISezionale":"A"}, {"olv:fatCliSDINumFattura":"836"}, {"olv:fatCliSDIDataFattura":"30/10/2017"}, {"olv:fatCliSDICodDestinatario":"4IG1F"}, {"olv:fatCliSDIStato":"HDO01"}, {"olv:fatCliSDIId":"4782600"} ] } ] }

updateDocuments: Sito di Test 6.13

La URL è: https://trustdoc.trusttechnologies.it/proxyTrustDoc/updateDocuments


NOTA BENE: Il momento temporale per il test di questa funzionalità deve essere concordato con l’HELP DESK di FATTURA ELETTRONICA SICURA, inviando una email di richiesta all’indirizzo di posta: Help Desk Fattura Elettronica Sicura .

updateDocuments: Sito di Produzione 6.14



Attenzione: non usare l’ambiente di produzione per fare delle prove. Le fatture alle quali viene assegnato lo stato di Accettata vengono versate automaticamente nel Sistema di Conservazione.

updateDocuments: Autenticazione al Servizio 6.15




In caso di autenticazione non riuscita verrà restituito un errore http 401: raccomandiamo di gestire questa evenienza, che si può tipicamente presentare nel momento in cui, per motivi di sicurezza, scadono le credenziali di accesso alla piattaforma.

updateDocuments: Parametri di Input del Servizio 6.16

Il servizio viene richiamato con i seguenti parametri in POST nella richiesta:

nome del sito

https://trustdoc.trusttechnologies.it/proxyTrustDoc/updateDocuments





nome classe documentale (“olv:FatCliSDI”)

un Json contenente per ciascuna fattura di cui aggiornare lo stato: la proprietà chiave per l’dentificazione della fattura le proprietà da aggiornare (coppie chiave:valore)

Proprietà chiave per l’identificazione della fattura 6.16.1

Le coppie chiave:valore che vanno inserite e valorizzate per l’identificazione della fattura che deve essere aggiornata sono almeno:

CHIAVE VALORI

olv:fatCliSDISezionale Valore contenuto nella chiave della fattura

olv:fatCliSDINumFattura Valore contenuto nella chiave della fattura ORI

olv:fatCliSDIAnno Valore contenuto nella chiave della fattura ALORI

Proprietà da aggiornare 6.16.2

La coppia chiave:valore che va aggiornata è:

PER NON SEGUIRE PIU’ LO STATO DELLA FATTURA:

CHIAVE VALORI AMMESSI

olv:escludi True

PER RICOMINCIARE A SEGUIRE LO STATO DELLA FATTURA:


olv:escludi False

updateDocuments: Esempio di chiamata HTTPS al Servizio 6.17

L’integrazione avviene attraverso una chiamata HTTP al servizio con le seguenti caratteristiche:

URL: http://trustdoc.trusttechnologies.it:8080/proxyTrustDoc/updateDocuments Method: POST JSON Request (parametri della richiesta) {

"site":"<Nome Sito >", "class":"<Nome Classe documentale>",

o “items”:”< un json contente, per ciascun documento da aggiornare, le proprietà chiave (“keys”)per l'identificazione della fattura (nel formato chiave:valore) e le proprietà da aggiornare (“metadata”) (sempre nel formato chiave:valore) >”,

}

N.B.: l’istruzione "site":"<Nome Sito >" può essere tralasciata se il cliente gestisce una sola ragione sociale. Se gestisce più di una ragione sociale, deve avere acquistato l’opzione “ULTERIORI RAGIONI SOCIALI”.

Esempio di JSON Request:

{ "site":"Collaudo", "class":"olv:fatCliSDI", "items": [ {

http://trustdoc.trusttechnologies.it:8080/proxyTrustDoc/


"keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"124"}, {"olv:fatCliSDIAnno":2017} ], "metadata": [ {"olv:escludi ":"true"} ] }, { "keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"125"}, {"olv:fatCliSDIAnno":2017} ], "metadata": [ {"olv:escludi ":"true"} ] }, { "keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"126"}, {"olv:fatCliSDIAnno":2017} ], "metadata": [ {"olv:escludi ":"true"} ] } ] }

updateDocuments: Response 6.18

Il servizio restituirà un valore 0000 in caso di esito positivo dell’aggiornamento; in caso di esito negativo, restituirà un Json contenente per ciascuna fattura elaborata gli estremi della stessa (in termini di chiave:valore), il codice e la descrizione dell’errore.


Response

{ “returnCode": "<codice esito operazione>", "description": "<descrizione in caso di esito negativo> “message”: “<json contenente per ciascuna fattura elaborata gli estremi della stessa (chiave:valore), il codice di errore e la descrizione.>”

}


Il parametro returnCode della Response potrà assumere i seguenti valori:

0000 : success

0100 : error

0101 : vincoli del modello non rispettati

0102 : query non valida

0103 : nome proprietà non valida


0104 : documento non trovato

Esempio di Response contenente errori 6.18.3

{ "returnCode":"0100", "description":"error", "message": [ { "keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"124"}, {"olv:fatCliSDIAnno":2017}, {"code":"0000"}, {"message":"operazione eseguita con successo"} ] }, { "keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"125"}, {"olv:fatCliSDIAnno":2017}, {"code":"0000"}, {"message":"operazione eseguita con successo"} ]},

{ "keys": [ {"olv:fatCliSDISezionale":"PA"}, {"olv:fatCliSDINumFattura":"126"}, {"olv:fatCliSDIAnno":2017}, {"code":"0104"}, {"message":"documento non trovato"} ] } ] }

Esempio di Response in assenza di errori 6.18.4

{ "returnCode":"0000", "description":"success" }

Fattura esemplificativa per Test 6.19

Si riporta di seguito a titolo di esempio una fattura di test che può essere utilizzate per le prove del webservice:

<?xml version="1.0" encoding="UTF-8"?> <v1:FatturaElettronica xmlns:v1="http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2" versione="FPA12"> <FatturaElettronicaHeader> <DatiTrasmissione>


<IdTrasmittente> <IdPaese>IT</IdPaese> <IdCodice>000000000000</IdCodice> </IdTrasmittente> <ProgressivoInvio>0000</ProgressivoInvio> <FormatoTrasmissione>FPA12</FormatoTrasmissione> <CodiceDestinatario>UF000</CodiceDestinatario> </DatiTrasmissione> <CedentePrestatore> <DatiAnagrafici> <IdFiscaleIVA> <IdPaese>IT</IdPaese> <IdCodice>00000000100</IdCodice> </IdFiscaleIVA> <CodiceFiscale>00000000100</CodiceFiscale> <Anagrafica> <Denominazione>Alpha Test</Denominazione> <Titolo>Azienda</Titolo> </Anagrafica> <RegimeFiscale>RF01</RegimeFiscale> </DatiAnagrafici> <Sede> <Indirizzo>Via Alpha</Indirizzo> <NumeroCivico>77</NumeroCivico> <CAP>10015</CAP> <Comune>IVREA</Comune> <Provincia>TO</Provincia> <Nazione>IT</Nazione> </Sede> <StabileOrganizzazione> <Indirizzo>Via Alpha</Indirizzo> <NumeroCivico>77</NumeroCivico> <CAP>10015</CAP> <Comune>IVREA</Comune> <Nazione>IT</Nazione> </StabileOrganizzazione> <IscrizioneREA> <Ufficio>TO</Ufficio> <NumeroREA>547040</NumeroREA> <CapitaleSociale>10000000.00</CapitaleSociale> <SocioUnico>SM</SocioUnico> <StatoLiquidazione>LN</StatoLiquidazione> </IscrizioneREA> <Contatti> <Telefono>0125 0000</Telefono> <Fax>0125 0000</Fax> <Email>[email protected]</Email> </Contatti> <RiferimentoAmministrazione>1234</RiferimentoAmministrazione> </CedentePrestatore> <CessionarioCommittente> <DatiAnagrafici> <IdFiscaleIVA> <IdPaese>IT</IdPaese> <IdCodice>000000000</IdCodice> </IdFiscaleIVA> <CodiceFiscale>0000000</CodiceFiscale> <Anagrafica> <Denominazione>Beta Test</Denominazione> </Anagrafica> </DatiAnagrafici> <Sede> <Indirizzo>Via Beta </Indirizzo> <NumeroCivico>1</NumeroCivico> <CAP>50134</CAP> <Comune>FIRENZE</Comune>


<Provincia>FI</Provincia> <Nazione>IT</Nazione> </Sede> </CessionarioCommittente> <TerzoIntermediarioOSoggettoEmittente> <DatiAnagrafici> <IdFiscaleIVA> <IdPaese>IT</IdPaese> <IdCodice>00000000</IdCodice> </IdFiscaleIVA> <Anagrafica> <Denominazione>Alpha Test</Denominazione> </Anagrafica> </DatiAnagrafici> </TerzoIntermediarioOSoggettoEmittente> </FatturaElettronicaHeader> <FatturaElettronicaBody> <DatiGenerali> <DatiGeneraliDocumento> <TipoDocumento>TD01</TipoDocumento> <Divisa>EUR</Divisa> <Data>2017-02-21</Data> <Numero>0980181857</Numero> <ImportoTotaleDocumento>1587.01</ImportoTotaleDocumento> <Causale>Contratto n.0000000000 del 19/11/2014Delibera 000000.DICV del 09/10/2014Fornitura generica</Causale> </DatiGeneraliDocumento> <DatiContratto> <IdDocumento>2017/000</IdDocumento> <Data>2017-02-21</Data> <CodiceCIG>6015583820</CodiceCIG> </DatiContratto> <DatiDDT> <NumeroDDT>0042001071</NumeroDDT> <DataDDT>2017-02-21</DataDDT> <RiferimentoNumeroLinea>10</RiferimentoNumeroLinea> </DatiDDT> <DatiDDT> <NumeroDDT>0042001071</NumeroDDT> <DataDDT>2017-02-21</DataDDT> <RiferimentoNumeroLinea>20</RiferimentoNumeroLinea> </DatiDDT> <DatiDDT> <NumeroDDT>0042001071</NumeroDDT> <DataDDT>2017-02-21</DataDDT> <RiferimentoNumeroLinea>30</RiferimentoNumeroLinea> </DatiDDT> <DatiDDT> <NumeroDDT>0042001071</NumeroDDT> <DataDDT>2017-02-21</DataDDT> <RiferimentoNumeroLinea>40</RiferimentoNumeroLinea> </DatiDDT> </DatiGenerali> <DatiBeniServizi> <DettaglioLinee> <NumeroLinea>10</NumeroLinea> <Descrizione>9241679 QIAcube Rental</Descrizione> <Quantita>1.00</Quantita> <UnitaMisura>WEE</UnitaMisura> <DataInizioPeriodo>2017-01-01</DataInizioPeriodo> <DataFinePeriodo>2017-01-31</DataFinePeriodo> <PrezzoUnitario>221.6600</PrezzoUnitario> <PrezzoTotale>221.6600</PrezzoTotale> <AliquotaIVA>22.00</AliquotaIVA> </DettaglioLinee> <DettaglioLinee> <NumeroLinea>20</NumeroLinea>


<Descrizione>9242772 EZ1 Advanced XL Rental</Descrizione> <Quantita>1.00</Quantita> <UnitaMisura>WEE</UnitaMisura> <DataInizioPeriodo>2017-01-01</DataInizioPeriodo> <DataFinePeriodo>2017-01-31</DataFinePeriodo> <PrezzoUnitario>204.1600</PrezzoUnitario> <PrezzoTotale>204.1600</PrezzoTotale> <AliquotaIVA>22.00</AliquotaIVA> </DettaglioLinee> <DettaglioLinee> <NumeroLinea>30</NumeroLinea> <Descrizione>9244480 QIAxpert Rental</Descrizione> <Quantita>1.00</Quantita> <UnitaMisura>WEE</UnitaMisura> <DataInizioPeriodo>2017-01-01</DataInizioPeriodo> <DataFinePeriodo>2017-01-31</DataFinePeriodo> <PrezzoUnitario>233.3400</PrezzoUnitario> <PrezzoTotale>233.3400</PrezzoTotale> <AliquotaIVA>22.00</AliquotaIVA> </DettaglioLinee> <DettaglioLinee> <NumeroLinea>40</NumeroLinea> <Descrizione>9241677 QIAsymphony Rental</Descrizione> <Quantita>1.00</Quantita> <UnitaMisura>WEE</UnitaMisura> <DataInizioPeriodo>2017-01-01</DataInizioPeriodo> <DataFinePeriodo>2017-01-31</DataFinePeriodo> <PrezzoUnitario>641.6700</PrezzoUnitario> <PrezzoTotale>641.6700</PrezzoTotale> <AliquotaIVA>22.00</AliquotaIVA> </DettaglioLinee> <DatiRiepilogo> <AliquotaIVA>22.00</AliquotaIVA> <ImponibileImporto>1300.83</ImponibileImporto> <Imposta>286.18</Imposta> <EsigibilitaIVA>S</EsigibilitaIVA> <RiferimentoNormativo>art. 17-ter del D.P.R. n. 633/1972 - Scissione dei pagamenti</RiferimentoNormativo> </DatiRiepilogo> </DatiBeniServizi> <DatiPagamento> <CondizioniPagamento>TP02</CondizioniPagamento> <DettaglioPagamento> <ModalitaPagamento>MP05</ModalitaPagamento> <DataRiferimentoTerminiPagamento>2017-02-21</DataRiferimentoTerminiPagamento> <GiorniTerminiPagamento>90</GiorniTerminiPagamento> <ImportoPagamento>1300.83</ImportoPagamento> <IstitutoFinanziario>Intesa Sanpaolo S.p.A.</IstitutoFinanziario> <IBAN>IT27000000000000000000000</IBAN> </DettaglioPagamento> <DettaglioPagamento> <ModalitaPagamento>MP05</ModalitaPagamento> <DataRiferimentoTerminiPagamento>2017-02-21</DataRiferimentoTerminiPagamento> <GiorniTerminiPagamento>90</GiorniTerminiPagamento> <ImportoPagamento>1300.83</ImportoPagamento> <IstitutoFinanziario>Deutsche Bank S.p.A.</IstitutoFinanziario> <IBAN>IT14000000000000000000000</IBAN> </DettaglioPagamento> <DettaglioPagamento> <ModalitaPagamento>MP05</ModalitaPagamento> <DataRiferimentoTerminiPagamento>2017-02-21</DataRiferimentoTerminiPagamento> <GiorniTerminiPagamento>90</GiorniTerminiPagamento> <ImportoPagamento>1300.83</ImportoPagamento> <IstitutoFinanziario>UniCredit S.p.A.</IstitutoFinanziario> <IBAN>IT03000000000000000000000</IBAN> </DettaglioPagamento> </DatiPagamento>


</FatturaElettronicaBody> </v1:FatturaElettronica>


7. FATTURE ELETTRONICHE CICLO PASSIVO

Caso d’uso 7.1

Attraverso il servizio “exportDocuments” si ottiene la lista dei documenti non ancora registrati e, se richiesto, i file contenenti le fatture stesse, per alimentare il sistema di registrazione delle fatture che dovrà successivamente restituire alla piattaforma le informazioni di registrazione, esito, data registrazione, protocollo, sezionale attraverso il servizio “updateDocuments”, aggiornando le informazioni e lo stato delle fatture archiviate su TrustDoc. Le sole fatture accettate e complete dei dati di registrazione saranno automaticamente inviate in conservazione. Le fatture così aggiornate non saranno più prese in considerazione dal successivo utilizzo di “exportDocuments”.

Attenzione: vengono scaricate le sole fatture e non gli allegati eventualmente contenuti. Questo per permettere da un lato di disporre di tutti i dati per fare la registrazione in modo automatico, dall’altro di non appensantire la trasmissione con documenti PDF a volte molto consistenti. Gli allegati sono comuqnue disponibili per la consultazione mediante interfaccia web e verranno versati automaticamente nel Sistema di Conservazione una volta notificata l’accettazione della Fattura.

Il servizio consente di scaricare fino ad un massimo di 300 fatture che si trovano nello stato “Ricevuta, non registrata”.

A valle di questa operazione occorre effettuare l’attività di rifiuto/accettazione e registrazione, invocando l’apposito servizio descritto in questo manuale. Tale servizio provvede a cambiare lo stato delle fatture.

Se si invoca nuovamente il servizio di download senza avere proceduto ad invocare quello di aggiornamento, le fatture scaricate saranno sempre le stesse, in quanto il servizio le trova ancora nello stato “Ricevuta, non registrata”.

Se il numero di fatture da scaricare fosse superiore a 300, si possono quindi reiterare in successione il servizio di download ed il servizio di aggiornamento, fino a quando non sarà inviato uno specifico messaggio di errore che informerà che non si sono più fatture da scaricare.

Il servizio restituisce un Json contenente, per ciascuna fattura ritornata:

le proprietà della fattura estratta (coppia chiave:valore , dove la chiave è il nome del metadato come da tabella fornita in questo manuale).

Lo stream della fattura XML

exportDocuments: Sito di Test 7.2



NOTA BENE: Il momento temporale per il test di questa funzionalità deve essere concordato con l’HELP DESK di FATTURA ELETTRONICA SICURA, inviando una email di richiesta all’indirizzo di posta: Help Desk Fattura Elettronica Sicura. Nell’ambiente di Test, previo accordo con l’Help Desk, saranno inserite fatture nello stato “Ricevuta, non Registrata” che è possibile scaricare e modificare.

exportDocuments: Sito di Produzione 7.3


https://trustdoc.trusttechnologies.it/proxyTrustDoc/exportDocuments





Le credenziali ed il nome del sito vengono fornite al richiedente all’attivazione del servizio.

Attenzione: non usare l’ambiente di produzione per fare delle prove.

exportDocuments: Autenticazione al Servizio 7.4




In caso di autenticazione non riuscita verrà restituito un errore http 401: raccomandiamo di gestire questa

evenienza, che si può tipicamente presentare nel momento in cui, per motivi di sicurezza, scadono le

credenziali di accesso alla piattaforma.

exportDocuments: Esempio di chiamata HTTPS al Servizio 7.5

L’integrazione avviene attraverso una chiamata HTTPS al servizio con le seguenti caratteristiche:

URL: https://trustdoc.trusttechnologies.it/proxyTrustDoc/exportDocuments Method: POST JSON Request (parametri della richiesta) {

"site":"<Nome Sito>", "class":"olv:fatForSDI", “xmlFile”: < true|false> // true abilita il download dell’xml della fattura>

}

N.B.: l’istruzione "site":"<Nome Sito >" può essere tralasciata se il cliente gestisce una sola ragione sociale. Se gestisce più di una ragione sociale, deve avere acquistata l’opzione “ULTERIORI RAGIONI SOCIALI”.

Si riporta di seguito un possibile esempio di JSON Request:

{ "site":"Collaudo", "class":"olv:fatForSDI", "xmlFile":"true" }

exportDocuments: Response del Servizio 7.6

Formato della Response: 7.6.1

{ “returnCode": "<codice esito operazione>", "description": "<descrizione in caso di esito negativo>

“message”: “<json array contenente l’elenco delle proprietà estratte in forma di coppia chiave:valore ed eventualmente lo stream dei file richiesti>” } Lo stato della fattura è mantenuto nella chiave olv:fatForSDIStato e indicato attraverso i seguenti valori:



HDO00: Ricevuta - non registrata

HDO01: Accettata

HDO02: Rifiutata

HDO03: Decorrenza Termini

HDO07: Scartata

Proprietà delle Fatture Elettroniche Fornitori restituite 7.6.2

Le proprietà relative alla classe documentale Fatture Elettroniche Fornitori (olv:fatForSDI) applicabili al caso d’uso e che saranno restituite, sono:

olv:fatForSDIRagSociale

olv:fatForSDIPivaCodFisc

olv:fatForSDIAnno

olv:fatForSDINumFattura

olv:fatForSDIDataEmissione

olv:fatForSDIId

olv:fatForSDIStato


Il parametro "returnCode" della Response potrà assumere i seguenti valori:

0000 : success

1111 : documenti non trovati per il criterio di selezione configurato

0100 : generic error;

Esempio di Response: 7.6.4

{ "returnCode": "0000", "description": "", "message": [ { "metadata": [ {"olv:fatForSDIRagSociale":"Arredamenti Rossi"}, {"olv:fatForSDIPicaCodFisc":"13579248083"}, {"olv:fatForSDIAnno":2017}, {"olv:fatForSDINumFattura":"7638"}, {"olv:fatForSDIDataEmissione":"23/03/2017"}, {"olv:fatForSDIId":"8472591"}, {"olv:fatForSDIStato":"HDO02"} ], "file":"<stream1 in base64>" }, { "metadata": [ {"olv:fatForSDIRagSociale":"Verdi Impianti Elettrici"}, {"olv:fatForSDIPicaCodFisc":"73579243081"}, {"olv:fatForSDIAnno":2017}, {"olv:fatForSDINumFattura":"7639"}, {"olv:fatForSDIDataEmissione":"23/03/2017"}, {"olv:fatForSDIId":"6274831"}, {"olv:fatForSDIStato":"HDO01"} ], "file": "<stream2 in base64>" }

] }


8. NOTIFICA DI RIFIUTO/ACCETTAZIONE

Caso d’uso 8.1

Il servizio “updateDocuments” consente di fornire al Portale le informazioni necessarie per concludere il processo di gestione delle fatture, cioè:

l’invio a SDI della notifica di accettazione/rifiuto

il versamento nel Sistema di Conservazione a Norma

NOTA BENE: Il servizio “exportDocument” permette di scarcare un massimo di 300 fatture alla volta, partendo da quelle che hanno data di emissione più lontana. E’ necessario che, prima di fare un ulteriore download, le fatture vengano registrate e accettate oppure rifiutate e che con il servizio ”updateDocuments” vengano aggiornate le fatture nello stato di “accettata o rifiutata”. Se infatti si invocasse immediatamente di nuovo il servizio “exportDocument” si otterrebbero le stesse fatture (in quanto ancora nello stato di “Ricevuta, non registrata”).

Si è preferito adottare questa logica per evitare che, nel caso di errori nel download (blocchi di lavorazione, ecc.), non fosse più possibile effettuare un nuovo download delle fatture, ovvero diventasse particolarmente complesso.

updateDocuments: Sito di Test 8.2



NOTA BENE: Il momento temporale per il test di questa funzionalità deve essere concordato con l’HELP DESK di FATTURA ELETTRONICA SICURA, inviando una email di richiesta all’indirizzo di posta: Help Desk Fattura Elettronica Sicura .

updateDocuments: Sito di Produzione 8.3



Attenzione: non usare l’ambiente di produzione per fare delle prove. Le fatture alle quali viene assegnato lo stato di Registrata vengono versate automaticamente nel Sistema di Conservazione.

updateDocuments: Autenticazione al Servizio 8.4









In caso di autenticazione non riuscita verrà restituito un errore http 401: raccomandiamo di gestire questa evenienza, che si può tipicamente presentare nel momento in cui, per motivi di sicurezza, scadono le credenziali di accesso alla piattaforma.

updateDocuments: Parametri di Input del Servizio 8.5

Il servizio viene richiamato con i seguenti parametri in POST nella richiesta:

nome del sito

nome classe documentale (“olv:FatForSDI”)

un Json contenente per ciascuna fattura di cui aggiornare lo stato: la proprietà chiave per l’dentificazione della fattura le proprietà da aggiornare (coppie chiave:valore)

Proprietà chiave per l’identificazione della fattura 8.5.1

Le coppie chiave:valore che vanno inserite e valorizzate per l’identificazione della fattura che deve essere aggiornata sono:

CHIAVE VALORI

olv:fatForSDIPivaCodFisc Partita Iva

olv:fatForSDINumFattura Numero Fattura

olv:fatForSDIAnno Anno

Proprietà da aggiornare 8.5.2

Le coppie chiave:valore che è obbligatorio aggiornare sono:

IN CASO DI ACCETTAZIONE:


olv:fatForSDINumProtocollo Stringa

olv:fatForSDISezionale Stringa

olv:fatForSDIDataRegistrazione AAAA/MM/GG

olv:fatForSDIStato Valorizzare con la costante: “HDO01”

IN CASO DI RIFIUTO:


olv:fatForSDINote Testo contenente la motivazione del rifiuto

olv:fatForSDIStato Valorizzare con la costante: “HDO02”

Attenzione: Nel campo NOTE va inserita la motivazione per la quale la fattura si rifiuta. Questa informazione viene trasmessa attraverso SDI a chi ha emesso la fattura.

updateDocuments: Esempio di chiamata HTTPS al Servizio 8.6

L’integrazione avviene attraverso una chiamata HTTP al servizio con le seguenti caratteristiche:

URL: http://trustdoc.trusttechnologies.it:8080/proxyTrustDoc/updateDocuments Method: POST JSON Request (parametri della richiesta) {

"site":"<Nome Sito >",

http://trustdoc.trusttechnologies.it:8080/proxyTrustDoc/


"class":"olv:fatForSDI",

o “items”:”< un json contente, per ciascun documento da aggiornare, le proprietà chiave (“keys”)per l'identificazione della fattura (nel formato chiave:valore) e le proprietà da aggiornare (“metadata”) (sempre nel formato chiave:valore) >”,

}

N.B.: l’istruzione "site":"<Nome Sito >" può essere tralasciata se il cliente gestisce una sola ragione sociale. Se gestisce più di una ragione sociale, deve avere acquistato l’opzione “ULTERIORI RAGIONI SOCIALI”.

Esempio di JSON Request:

{ "site":"Collaudo", "class":"olv:fatForSDI", "items": [ { "keys": [ {"olv:fatForSDIPivaCodFisc":"84736422918"}, {"olv:fatForSDINumFattura":"8725"}, {"olv:fatForSDIAnno":2017} ], "metadata": [ {"olv:fatForSDINumProtocollo":"3456/2017"}, {"olv:fatForSDISezionale":"A"}, {"olv:fatForSDIDataRegistrazione":"12/06/2017"}, {"olv:fatForSDIStato":"HDO01"} ] }, { "keys": [ {"olv:fatForSDIPivaCodFisc":"66736422611"}, {"olv:fatForSDINumFattura":"39581"}, {"olv:fatForSDIAnno":2017} ], "metadata": [ {"olv:fatForSDINote":"codice CUP errato; quello corretto è G22I14000220002"}, {"olv:fatForSDIStato":"HDO02"} ] } ] }

updateDocuments: Response 8.7

Il servizio restituirà un OK in caso di esito positivo dell’aggiornamento; in caso di esito negativo, restituirà un Json contenente per ciascuna fattura elaborata gli estremi della stessa (in termini di chiave:valore), il codice e la descrizione dell’errore.


Response

{ “returnCode": "<codice esito operazione>", "description": "<descrizione in caso di esito negativo> “message”: “<json contenente per ciascuna fattura elaborata gli estremi della stessa (chiave:valore), il codice di errore e la descrizione.>”

}



Il parametro returnCode della Response potrà assumere i seguenti valori:

0000 : success

0100 : error

0101 : vincoli del modello non rispettati

0102 : query non valida

0103 : nome proprietà non valida

0104 : documento non trovato

Esempio di Response contenente errori 8.7.3

{ "returnCode":"0100", "description":"error", "message": [ [ {"olv:fatForSDIPivaCodFisc":"84736422918"}, {"olv:fatForSDINumFattura":"8725"}, {"olv:fatForSDIAnno":2017}, {"code":"0000"}, {"message":"operazione eseguita con successo"} ], [ {"olv:fatForSDIPivaCodFisc":"66736422611"}, {"olv:fatForSDINumFattura":"39581"}, {"olv:fatForSDIAnno":2017}, {"code":"0104"}, {"message":"documento non trovato"} ] ] }

Esempio di Response in assenza di errori 8.7.4

{ "returnCode":"0000", "description":"success" }

9. INFO E ASSISTENZA IN PRODUZIONE

Per ogni necessità, una volta in Produzione, puoi contattare il nostro Help Desk, dal lunedì al venerdì dalle 09:00 alle 18:30, al Numero Verde:

o inviare una mail a: Help Desk Fattura Elettronica Sicura

Ti ricordiamo che l’Help Desk è finalizzato a risolvere eventuali problemi di malfunzionamento o problemi nella fase di integrazione, e non fornisce supporto alla compilazione della fattura, tema per il quale ti chiediamo di prendere contatto, se necessario, con il tuo commercialista o consulente fiscale.


Fattura Elettronica Sicura - trusttechnologies.it · Per l’approfondimento di ome eseritare...

Documents

Transcript of Fattura Elettronica Sicura - trusttechnologies.it · Per l’approfondimento di ome eseritare...