cs-test.teamsystem.comcs-test.teamsystem.com/knos/wcf/cs/doc/cs-webservices... · web viewservizio...
TRANSCRIPT
TeamSystem®
Servizio CCT
Servizio CCTWeb Services
Versione
1.6.012 Aprile 2016
Servizio CCTWeb Services – Specifiche Tecniche
Specifiche Tecniche
1
Servizio CCTWeb Services – Specifiche Tecniche
Servizio CCTWeb Services – Specifiche Tecniche
SommarioVersioni del documento 5
Parte 1 7
1 Introduzione 7
2 Terminologia 8
3 Logica generale di funzionamento 103.1 Tecnologia utilizzata 103.2 Convenzioni sui nomi utilizzati 103.3 Localizzazione messaggi 123.4 Parametri di input e output 123.5 Gestione delle Versioni 133.6 Modalità di test, documentazione ed esempi 143.7 Flusso operativo: schema generale ed esempio 15
Parte 2 16
4 Web Services del Servizio CCT 164.1 Utilizzo degli Endpoint 174.2 Servizio: UserAuthentication 17
4.2.1 Operazione: BasicAuthentication 184.2.2 Operazione: GetTicket 194.2.3 Operazione: DigestAuthentication 20
4.3 Servizio: FileTransfer 224.3.1 Operazione: UploadPdI 224.3.2 Operazione: UploadTypedPdI 244.3.3 Operazione: DownloadFile 26
4.4 Servizio: ServizioCS 274.4.1 Operazione: GetPdI 274.4.2 Operazione: GetTypedPdI 284.4.3 Operazione: SearchPdI 294.4.4 Operazione: SearchTypedPdI 31
Appendice A 34
5 Workflow del PdI 34
Appendice B 36
6 Parametri di tipo oggetto 366.1 ServiceInfo 366.2 NameValue 366.3 BaseUserIdentity 376.4 UserIdentity 376.5 BasicAuthentication 376.6 DigestAuthentication 376.7 SoggettoProduttore, SoggettoTitolare 386.8 SoggettoOrigine, SoggettoDestinazione 386.9 DatiDocumento 39
1
Servizio CCTWeb Services – Specifiche Tecniche
6.10 PdIBase 496.11 PdI1001 516.12 PdI1002 526.13 PdI1003 536.14 PdI1004 546.15 PdI1005 556.16 PdI2001 566.17 PdI2002 576.18 PdI2003 586.19 PdI2004 596.20 PdI2005 606.21 PdI2006 616.22 PdI2007 626.23 PdI2008 636.24 PdI2009 646.25 PdI2010 656.26 PdI2011 666.27 PdI2012 676.28 PdI2013 686.29 PdI2014 696.30 PdI2015 706.31 PdI2016 716.32 PdI2017 726.33 PdI2018 736.34 PdI2019 746.35 PdI2020 756.36 PdI2021 766.37 PdI2022 776.38 PdI2023 786.39 PdI2024 796.40 PdI2025 806.41 PdI2026 816.42 PdI2027 826.43 PdI2028 836.44 PdI2029 846.45 PdI2030 856.46 PdI2031 866.47 PdI2032 876.48 PdI2033 886.49 PdI2034 896.50 PdI2035 906.51 PdI2036 916.52 PdI2037 926.53 PdI2038 936.54 PdI2039 946.55 PdI2040 956.56 PdI2041 966.57 PdI2042 976.58 PdI2043 986.59 PdI2044 996.60 PdI2045 100
2
Servizio CCTWeb Services – Specifiche Tecniche
6.61 PdI2046 1016.62 PdI2047 1026.63 PdI2048 1036.64 PdI2049 1046.65 PdI2050 1056.66 PdI2051 1066.67 PdI2052 1076.68 PdI2053 1086.69 PdI2054 1096.70 PdI2055 1096.71 PdI2056 1106.72 PdI2057 1106.73 PdI2058 1116.74 PdI2059 1116.75 InfoPdI 1126.76 InfoTypedPdI 1156.77 InfoPdI1001 1176.78 InfoPdI1002 1186.79 InfoPdI1003 1206.80 InfoPdI1004 1206.81 InfoPdI1005 1216.82 InfoPdI2001 1216.83 InfoPdI2002 1226.84 InfoPdI2003 1226.85 InfoPdI2004 1236.86 InfoPdI2005 1236.87 InfoPdI2006 1246.88 InfoPdI2007 1246.89 InfoPdI2008 1256.90 InfoPdI2009 1256.91 InfoPdI2010 1266.92 InfoPdI2011 1266.93 InfoPdI2012 1276.94 InfoPdI2013 1276.95 InfoPdI2014 1286.96 InfoPdI2015 1286.97 InfoPdI2016 1296.98 InfoPdI2017 1296.99 InfoPdI2018 1306.100 InfoPdI2019 1306.101 InfoPdI2020 1316.102 InfoPdI2021 1316.103 InfoPdI2022 1326.104 InfoPdI2023 1326.105 InfoPdI2024 1336.106 InfoPdI2025 1336.107 InfoPdI2026 1346.108 InfoPdI2027 1346.109 InfoPdI2028 1346.110 InfoPdI2029 1356.111 InfoPdI2030 135
3
Servizio CCTWeb Services – Specifiche Tecniche
6.112 InfoPdI2031 1366.113 InfoPdI2032 1366.114 InfoPdI2033 1366.115 InfoPdI2034 1376.116 InfoPdI2035 1376.117 InfoPdI2036 1386.118 InfoPdI2037 1386.119 InfoPdI2038 1386.120 InfoPdI2039 1396.121 InfoPdI2040 1396.122 InfoPdI2041 1396.123 InfoPdI2042 1406.124 InfoPdI2043 1406.125 InfoPdI2044 1416.126 InfoPdI2045 1416.127 InfoPdI2046 1416.128 InfoPdI2047 1426.129 InfoPdI2048 1426.130 InfoPdI2049 1436.131 InfoPdI2050 1436.132 InfoPdI2051 1446.133 InfoPdI2052 1446.134 InfoPdI2053 1446.135 InfoPdI2054 1456.136 InfoPdI2055 1456.137 InfoPdI2056 1456.138 InfoPdI2057 1466.139 InfoPdI2058 1466.140 InfoPdI2059 1466.141 FileInfo 1476.142 SearchPdI 1486.143 SearchExpression 1506.144 SearchClause 1506.145 Argument 1506.146 OrderBy 1516.147 SearchPdIOutput 151
Appendice C 152
7 Valori enumerati 1527.1 PdIFileType 1527.2 HashType 1547.3 Operator 1547.4 ArgType 1557.5 Direction 155
Appendice C 156
8 Elenco errori 1568.1 Errori nei dati della richiesta 1578.2 Errori di sicurezza 1598.3 Errori in fase di elaborazione 159
4
Servizio CCTWeb Services – Specifiche Tecniche
5
Servizio CCTWeb Services – Specifiche Tecniche
Versioni del documento
Versione 1.6.0
Data 12/04/2015
Autori Samantha Tedesco, Davide Nani, Giampiero Levo
Descrizione
Aggiunti i tipi di documento 2055, 2056, 2057, 2058, 2059.Aggiunto il DataMember CodiceDestinatario ai tipi documento 2001, 2002, 2003, 2004
Versione 1.5.0
Data 20/10/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Aggiunto il DataMember Tipo ai tipi documento 2022, 2028, 2029, 2030, 2031, 2032.
Versione 1.4.0
Data 17/10/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Rimosso il DataMember SoggettoProduttore dall’operation contract UploadTypedPdI.Aggiunte le estensioni di file ammesse per ogni singola tipologia di documento.
Versione 1.3.1
Data 17/10/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Rimosso il DataMember SoggettoProduttore dall’operation contract UploadTypedPdI.Aggiunte le estensioni di file ammesse per ogni singola tipologia di documento.
6
Servizio CCTWeb Services – Specifiche Tecniche
Versione 1.3.0
Data 11/10/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Aggiunta l’OperationContract UploadTypedPdI che consente l’upload di PdI tramite DataContract tipicizzati.Aggiunte le OperationContract GetTypedPdI e SearchTypedPdI che consentono di ricercare PdI ottenendo come risultato DataContract tipicizzati.
Versione 1.2.0
Data 20/10/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Aggiunto al DataContract SearchFEOutputDC il parametro PartialRecordCount.Aggiunte le spiegazioni relative al funzionamento dell’OperationContract SearchFE.
Versione 1.1
Data 17/09/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Correzione nome campo CodiceDestinazioneIPA in CodiceDestinatarioIPA.
Versione 1.0
Data 03/08/2015
Autori Davide Nani, Giampiero Levo
Descrizione
Documentazione progetto.
7
Servizio CCTWeb Services – Specifiche Tecniche
1 IntroduzioneMotivazioni e finalità del presente documento
Lo scopo di questo documento è fornire la documentazione tecnica sui Web Services esposti dal Servizio di Conservazione Sostitutiva in Cloud di TeamSystem (Servizio CCT).
Questo documento è rivolto agli utenti accreditati che vogliono interfacciarsi programmaticamente al servizio per:
trasmettere documenti da conservare monitorare/scaricare pacchetti di archiviazione
8
Parte 1
Servizio CCTWeb Services – Specifiche Tecniche
2 TerminologiaSignificato dei termini utilizzati nel presente documento
Conservazione Sostitutiva
E’ la procedura prevista dalle attuali leggi in materia fiscale (DPR 59 del 12-3-2014)) che consente di dematerializzare i documenti cartacei e conservare gli equivalenti digitali rispettando certe regole (firma digitale, marcatura temporale, ecc.) in grado di garantire i requisiti di legge (autenticità, integrità, affidabilità, leggibilità, reperibilità) che attribuiscono piena validità ai fini legali e fiscali.
La normativa stabilisce anche le regole con cui devono essere conservati i documenti fiscali emessi direttamente in formato elettronico. Per questi non si ha una dematerializzazione ovvero una sostituzione del documento cartaceo originale e ultimamente ci si sta orientando verso il termine di Conservazione Digitale o in modo più neutro di Conservazione a Norma come sinonimi più qualificati per la Conservazione Sostitutiva.
Pacchetto Informativo E’ un contenitore che racchiude uno o più oggetti da conservare (documenti informatici, fascicoli informatici, aggregazioni documentali informatiche), o anche solo i metadati riferiti agli oggetti da conservare.
Pacchetto di Versamento (PdV)
E’ un pacchetto informativo inviato dal produttore al sistema di conservazione secondo un formato predefinito e concordato descritto nel manuale di conservazione.
Pacchetto di Archiviazione(PdA)
E’ un pacchetto informativo composto dalla trasformazione di uno o più pacchetti di versamento secondo le specifiche definite dall’attuale normativa.
Pacchetto di Distribuzione(PdD)
E’ un pacchetto informativo inviato dal sistema di conservazione all’utente in risposta ad una sua richiesta.
KnoS E’ il DMS che ospita le personalizzazioni richieste.
Pubblicazione E’ l’elemento base per l’organizzazione delle informazioni su KnoS. Una pubblicazione è un oggetto caratterizzato da attributi che può ospitare uno o più file allegati ed essere messo in relazione con altre pubblicazioni.
Tipologia Le tipologie definiscono categorie di pubblicazioni che hanno in comune gli stessi attributi e uno stesso workflow. Una pubblicazione è
9
Servizio CCTWeb Services – Specifiche Tecniche
sostanzialmente un’istanza di una certa tipologia.
Attributi Sono i metadati associati alle pubblicazioni definibili e valorizzabili dagli utenti o da programma.Gli attributi si dividono in due classi principali: gli attributi semplici (o mono valore) e gli attributi di tipo elenco (pubblicazioni o valori enumerati).
Documenti Sono i file allegati alle pubblicazioni dagli utenti o da programmi. Comprendono sia i file destinati alla Conservazione Sostitutiva che i file intermedi di indicizzazione, ecc.
Web Services CS Sono i web services esposti da KnoS per consentire l’accesso in via programmatica al servizio in alternativa all’interfaccia web.
10
Servizio CCTWeb Services – Specifiche Tecniche
3 Logica generale di funzionamentoA cosa servono i Web Services e qual è la logica di funzionamento
I Web Services sono stati introdotti sulla piattaforma del Servizio CCT per consentire ai clienti l’automatizzazione completa delle operazioni coinvolte nel processo della conservazione sostitutiva.
La logica di funzionamento del Servizio CCT non cambia con l’introduzione dei Web Services e vengono comunque mantenute le modalità tradizionali di upload e download da interfaccia web.
Oltre a sostituire le procedure manuali di upload e download i Web Services permetteranno anche il monitoraggio dello stato dei documenti conservati e l’ottenimento di dati statistici consentendo agli utenti di realizzare all’occorrenza una propria interfaccia completa verso il Servizio CCT.
3.1 Tecnologia utilizzataI Web Services del Servizio CCT TeamSystem sono realizzati utilizzando Microsoft WCF 4.5 come componente per l’infrastruttura di base.
Il protocollo di scambio implementato è SOAP 1.2.
Per lo scambio di file (upload/download) si utilizza MTOM (Message Transmission Optimization Mechanism).
I Web Services implementati restituiscono i dettagli sull’interfaccia implementata se richiamati con ?wsdl o ?singlewsdl.
Oltre alle informazioni contenute in questo documento e all’auto-documentazione restituita dai Web Services verrà fornito anche un progetto sviluppato in C# con esempi dettagliati di richiamo per tutte le operazioni disponibili.
3.2 Convenzioni sui nomi utilizzatiLa piattaforma su cui si basa l’applicativo utilizza nei propri Web Services interni una nomenclatura basata su termini inglesi. Dovendo mettere in comunicazione la terminologia inglese con la termilogia italiana relativa all’argomento conservazione sostitutiva si è adottato un approccio neutrale che cercasse di mantenere i nomi originali per semplificare la comprensione dei concetti che stanno alla base dei servizi, delle operazioni e dei parametri implementati.
11
Servizio CCTWeb Services – Specifiche Tecniche
Si è quindi ritenuto inutile operare una scelta per una lingua o per l’altra e quindi tradurre termini come “Soggetto Conservante”, “PdI”, ecc. in inglese o, viceversa, ritradurre in italiano una quantità di termini molto superiore che deriva dal DMS KnoS alla base del Servizio CCT. Questo approccio ha il pregio di mantenere la corrispondenza con i termini originali in entrambe le lingue ed elimina il rischio, sempre in agguato quando si procede a tradurre concetti locali specifici nella lingua di altre nazioni, di trovare parole non traducibili o almeno non traducibili in termini sintetici o con un significato perfettamente equivalente all’originale.
In conclusione la convenzione adottata è la seguente:
tutti i nomi relativi a concetti provenienti da KnoS sono espressi con i termini originali in inglese (IdStatus, StatusName, DateCreation, ecc.);
tutti i nomi relativi a concetti provenienti dalla conservazione sostitutiva hanno mantenuto il loro nome originale con l’eventuale aggiunta del suffisso o del prefisso PdI, PdD per rimarcarne la tipologia;
per i concetti generali che sono però collegati a concetti locali è ammesso l’uso di nomi ibridi quando il termine originato risulta chiaramente comprensibile e non eccessivamente stravagante. Ad esempio UploadPdI è stato utilizzato come nome del metodo atto all’invio di documenti da conservare poiché il termine upload è di uso generico ed è diventato comune anche nella lingua italiana.
nei casi ambigui si è lasciata agli sviluppatori la libertà di scelta dei nomi per cui ad esempio si sono preferiti termini come ElencoInfoPdI a cose tipo InfoPdIList, mentre per indicare gli elenchi dei file di un PdI il termine FileList è sembrato più appropriato in quanto facilmente comprensibile e già presente all’interno di KnoS
Ci auguriamo, con le scelte fatte, di non urtare troppo la sensibilità e il gusto linguistico degli utilizzatori dei nostri Web Services.
“Stat rosa pristina nomine, nomina nuda tenemus”(Umberto Eco – Il nome della rosa)
“What’s in a name? That which we call a roseBy any other name would smell as sweet.”
(William Shakespeare – Romeo and Juliet)
12
Servizio CCTWeb Services – Specifiche Tecniche
3.3 Localizzazione messaggi La lingua di default dei messaggi, tipicamente di eccezione, restituiti dai vari metodi dei web services è l’italiano.
È possibile però impostare i web services affinchè utilizzino la lingua inglese per i messaggi restituiti; per far ciò occorre aggiungere il nodo “Language” all’header della richiesta soap come illustrato di seguito:
<s:Envelope xmlns:s=”http://www.w3.org/2003/05/soap-envelope”><s:Header>
<Language xmlns=”KnosCSServices”>en</Language></s:Header><s:Body>
<BasicAuthentication xmlns=”http://www.teamsystem.com/”><BasicAuthentication
xmlns:a=”http://schemas.datacontract.org/2004/07/KnosCS.Services.DataContracts.Input” xmlns:i=”http://www.w3.org/2001/XMLSchema-instance”>
<a:Password>Password</a:Password><a:UserName>Username</a:UserName>
</BasicAuthentication></BasicAuthentication>
</s:Body></s:Envelope>Si vedano le applicazioni di demo in ASP.NET e Java per approfondire l’implementazione.
3.4 Parametri di input e outputTutti i Web Service del Servizio CCT sono auto-documentati tramite WSDL, in questo documento vengono fornite le specifiche in termini descrittivi ponendo l’accento sulle regole non specificabili tramite WSDL. I parametri di tipo semplice utilizzati sono:
o stringa stringa unicode con lunghezza massima fino a 200 caratterio testo testo unicode di lunghezza superiore ai 200 caratterio intero numero intero con segno a 32 bito data-ora data e ora o enumerato valore di tipo stringa preso da un elenco di valori predefinitio file file allegato alla richiesta/risposta
Per il tipo stringa la presenza di un eventuale numero tra parentesi indica la lunghezza massima accettata, ad esempio:
stringa (100) indica una stringa di testo di lunghezza massima di 100 caratteri unicode
Eventuali restrizioni o indicazioni sui caratteri utilizzabili (ad esempio per i nomi dei file) sono indicate nei capitoli che descrivono l’operazione specifica.
13
Servizio CCTWeb Services – Specifiche Tecniche
Per il tipo testo si indica sempre la dimensione massima accettata, che sarebbe altrimenti arbitraria e potenzialmente invasiva, con la stessa sintassi utilizzata per la stringa:
testo (1000) indica un testo di lunghezza massima di 1000 caratteri unicode
I parametri di tipo oggetto sono costituiti da insiemi di tipi semplici, elenchi di tipi semplici o elenchi di oggetti.
Il contenuto di questi tipi è dettagliato solo la prima volta che vengono descritti. L’appendice B documenta nel dettaglio i parametri di tipo oggetto utilizzati nei DataContract.
3.5 Gestione delle VersioniTutte le operazioni esposte dai servizi restituisco in output il parametro ServiceInfo che contiene nella proprietà ServiceVersion (di tipo stringa) la versione corrente del servizio.
Parametro di Output Tipo Descrizione
ServiceInfo oggetto Contenitore per la versione corrente del Servizio ed eventuali informazioni aggiuntive.
ServiceVersion stringa Versione corrente del servizio.
La versione è espressa come sequenza di tre numeri separati da punto:
VersionNumber . ReleaseNumber . BuildNumber
Ad esempio Version = “1.2.3” indica che:
VersionNumber = 1 è il numero di versioneReleaseNumber = 2 è il numero di rilascioBuildNumber = 3 è il numero di compilazione
La regola adottata internamente è che ogni volta che si ricompilano i Web Services a fronte di una modifica significativa si incrementa il numero di compilazione.
Se la modifica determina una variazione nell’interfaccia dei Web Services (ad esempio l’aggiunta di una operazione o di un parametro) che non altera la compatibilità con la versione precedente si incrementa il numero di rilascio e si azzera il numero di compilazione.
Se la modifica è tale da rendere incompatibile il servizio con la versione precedente allora si crea un nuovo servizio con lo stesso nome a cui si appende il numero di versione, fa eccezione a questa regola la versione iniziale del servizio che non riporta il numero di versione.
Ad esempio le operazioni del servizio ServizioCS restituiranno come versioni:
1.0.0, 1.0.1, … , 1.2.0, 1.2.1, …
14
Servizio CCTWeb Services – Specifiche Tecniche
Quando si renderà necessaria una modifica di versione (rottura della compatibilità con l’interfaccia precedente) si realizzerà il servizio ServizioCS2 le cui operazioni restituiranno come versioni:
2.0.0, 2.0.1, … , 2.2.0, 2.2.1, …
L’introduzione di una nuova versione non elimina (a meno che non sia indispensabile) la versione precedente, per cui il client sarà libero di richiamare il servizio ServizioCS o il servizio ServizioCS2. Ovviamente uno dei due servizi potrebbe non offrire tutte le funzionalità dell’altro.
È anche possibile avere scenari misti per cui un client continua a richiamare il servizio ServizioCS per le operazioni già implementate mentre richiama ServizioCS2 solo per le nuove funzionalità introdotte.
3.6 Modalità di test, documentazione ed esempiÈ disponibile un sito di test per lo sviluppo dell’integrazione. I Web Services del Servizio CCT sono ospitati nella cartella all’indirizzo:
http://CS-test.teamsystem.com/knos/wcf/CS
La cartella:http://CS-test.teamsystem.com/knos/wcf/CS/samples
contiene un progetto di esempio in Visual Studio 2013.
La cartella:http://CS-test.teamsystem.com/knos/wcf/CS/doc
contiene la documentazione di progetto nelle varie versioni, per semplificare il controllo su eventuali novità all’indirizzo:
http://CS-test.teamsystem.com/knos/wcf/CS/news.htm
è presente una semplice pagina HTML di testo che riepiloga lo stato di avanzamento.
Le credenziali di accesso al sito di demo vengono rilasciate su richiesta.
15
Servizio CCTWeb Services – Specifiche Tecniche
3.7 Flusso operativo: schema generale ed esempioPrima di poter eseguire una qualunque altra operazione l’utente deve autenticarsi fornendo l’utente e la password rilasciati dagli operatori del Servizio CCT.
All’utente che esegue correttamente la procedura di autenticazione viene rilasciato un SecurityToken (Token di sicurezza) che andrà passato come parametro in tutte le richieste successive.
Ecco una sequenza tipica di richiamo Web Services per la gestione di una fattura:
16
Servizi CS Utente
UserAuthentication
UserName, Ticket, Digest Password/Digest Token di sicurezza
UploadPdISecurityToken, Documento da conservare
IdPdI
StatoPdI Stato PdI, notifiche, file
SecurityToken, IdPdI
RicercaPdI
SecurityToken, IdObject, IdDoc
File della conservazione sostitutiva
GetTicket
DigestAuthentication
BasicAuthentication
Ticket
ServizioCS
SecurityToken, Parametri di ricerca
Elenco PdI paginato
DownloadFile
FileTransfer
FileTransfer
Servizio CCTWeb Services – Specifiche Tecniche
4 Web Services del Servizio CCT Definizione e logica dei servizi implementati
L’architettura dei Web Services implementati dal Servizio CCT di TeamSystem prevede due servizi comuni per l’autenticazione e trasferimento file e poi servizi separati per tipologia di operazione o per classe di utenza che verranno rilasciati gradualmente.
L’implementazione completa dei Web Services avverrà in fasi successive. Allo stato attuale si prevede l’implementazione dei seguenti servizi:
UserAuthentication /knos/wcf/CS/UserAuthentication.svc
FileTransfer /knos/wcf/CS/FileTransfer.svc
ServizioCS /knos/wcf/CS/ServizioCS.svc
I primi due servizi sono di uso generale e consentono l’autenticazione e il trasferimento di file in upload e download.
Nella prima fase l’interazione via Web Services verrà offerta ai soli utenti degli Enti di Caricamento tramite ServizioCS.
In seguito verranno aggiunte nuove operazioni e/o servizi utili alla gestione amministrativa del servizio (recupero dei dati statistici, gestione dei dati di fatturazione, ecc.) alle altre categorie di utenti (amministratori, rivenditori, ecc.).
17
Parte 2
Servizio CCTWeb Services – Specifiche Tecniche
4.1 Utilizzo degli EndpointAttualmente i servizi sono raggiungibili sia via HTTP (solamente in ambiente di test) sia via HTTPS e per ciascun protocollo espongono 3 Endpoint: uno con codifica “classica” Text, uno con codifica MTOM (Message Transmission Optimization Mechanism) e una con codifica Binary.
L’utilizzo della codifica MTOM riduce la dimensione dei messaggi SOAP inviati/ricevuti e quindi è da preferirsi, soprattutto per l’upload/download di file, quando il client utilizzato lo supporta (ASP.NET, Java, ecc.); discorso analogo per la codifica Binary che è ancora più compatta di quella MTOM: essa però è utilizzabile solamente interfacciandosi da client sviluppati in ASP.NET.
Il servizio FileTransfer espone quindi i seguenti Endpoint:
/knos/wcf/CS/FileTransfer.svc/http
/knos/wcf/CS/FileTransfer.svc/http/mtom
/knos/wcf/CS/FileTransfer.svc/http/binary
/knos/wcf/CS/FileTransfer.svc/https
/knos/wcf/CS/FileTransfer.svc/https/mtom
/knos/wcf/CS/FileTransfer.svc/https/binary
Si vedano le applicazioni demo di esempio per l’utilizzo specifico.
4.2 Servizio: UserAuthenticationÈ un servizio trasversale a tutti gli utenti che consente di ottenere il Token di Sicurezza da utilizzare per tutte le chiamate successive ai web service esposti.
Per ottenere il Token di Sicurezza l’applicativo deve disporre delle credenziali (UserName e Password) dell’utente corrente. Il token ottenuto è valido a tempo indeterminato (salvo eventuali operazioni di reset eseguite sul server che sono però eventi eccezionali) e garantisce a chiunque ne sia in possesso le credenziali di accesso dell’utente per cui è stato rilasciato.
È cura dell’applicativo che ottiene il Token di Sicurezza mantenerlo segreto per evitare che possa essere utilizzato da soggetti diversi dall’utente autorizzato.
Le operazioni offerte dal servizio UserAuthentication sono:
BasicAuthentication GetTicket DigestAuthentication
18
Servizio CCTWeb Services – Specifiche Tecniche
19
Servizio CCTWeb Services – Specifiche Tecniche
4.2.1 Operazione: BasicAuthenticationL’autenticazione di base è fornita ai client che non intendono utilizzare la procedura di autenticazione con Digest SHA1. Questo tipo di autenticazione è normalmente sconsigliato perché la password viaggia in chiaro ma poiché il servizio CCT è offerto in HTTPS anche questo metodo di autenticazione è da considerarsi sufficientemente sicuro.
Parametri di Input Tipo Descrizione
BasicAuthentication oggetto Contenitore per i parametri di autenticazione di base
UserName stringa nome utente (non importa se LowerCase oppure no)
Password stringa password
e ottenendo in risposta:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
UserIdentity oggetto Contenitore per SecurityToken.
SecurityToken stringa Token di sicurezza utilizzato per l’autenticazione dell’utente.
Oppure un errore SOAP.
20
Servizio CCTWeb Services – Specifiche Tecniche
4.2.2 Operazione: GetTicketQuesta operazione consente di ottenere dal server un Ticket da utilizzare nell’operazione di DigestAuthentication. Non è necessario richiamare questa operazione se l’autenticazione è fatta con l’operazione di BasicAuthentication.
La richiesta va formulata con i seguenti parametri:
Parametri di Input Tipo Descrizione
BaseUserIdentity oggetto Contenitore per i parametri di base di identificazione dell’utente
Username stringa nome utente (non importa se LowerCase oppure no)
e la risposta restituisce:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
Ticket stringa Ticket da utilizzare nell’operazione di DigestAuthentication.
ClientIPAddress Stringa Indirizzo IP del client che ha effettuato la richiesta
oppure un errore SOAP.
ServiceInfo è un contenitore per informazioni relative al servizio corrente. Ospita sempre almeno la proprietà ServiceVersion che indica la versione corrente del servizio.
21
Servizio CCTWeb Services – Specifiche Tecniche
4.2.3 Operazione: DigestAuthenticationLa DigestAuthentication viene eseguita in due passi:
- il client richiama l’operazione GetTicket per ottenere il Ticket- una volta ottenuto il Ticket viene utilizzato per produrre un Digest così calcolato:
Digest = SHA1(LowerCase(UserName) + clientIPAddress +
UpperCase(SHA1(LowerCase(UserName) + LowerCase(password))) + Ticket)
Dove:SHA1(argomento) indica l’applicazione dell’hashing SHA1 sull’argomento
LowerCase(argomento) indica la conversione in minuscolo dell’argomento
UpperCase(argomento) indica la conversione in maiuscolo dell’argomento
argomento1 + argomento2 indica la concatenazione dei due argomenti
La conversione in minuscole è richiesta perché nelle versioni attuali di KnoS sia il nome utente che la password sono Case Insensitive.
Per il calcolo dello SHA1 è inoltre richiesto l’utilizzo dell’encoding “ISO-8859-1”.
Una volta ottenuto il Digest il client può invocare l’operazione di DigestAuthentication passando come parametri della richiesta:
Parametri di Input Tipo Descrizione
DigestAuthentication oggetto Contenitore per UserName, Ticket e Digest.
UserName stringa Nome utente (non importa se LowerCase oppure no).
Ticket stringa Ticket fornito dall’operazione GetTicket.
Digest stringa Calcolato con la formula indicata sopra.
E ottenendo in risposta:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
22
Servizio CCTWeb Services – Specifiche Tecniche
UserIdentity oggetto Contenitore per SecurityToken.
SecurityToken stringa Token di sicurezza utilizzato per l’autenticazione dell’utente.
Oppure un errore SOAP.
23
Servizio CCTWeb Services – Specifiche Tecniche
4.3 Servizio: FileTransferÈ il servizio che gestisce le operazioni di upload e download via MTOM.Supporta le seguenti operazioni:
UploadPdI UploadTypedPdI DownloadFile
È possibile inviare una solo pacchetto di indicizzazione alla volta tramite l’operazione UploadPdI e UploadTypedPdI; l’upload è consentito solo agli utenti degli Enti di Caricamento abilitati.
UploadTypedPdI consente l’upload di documenti tramite DataContract tipicizzati (facilitando quindi l’identificazione delle proprietà da valorizzare a seconda del tipo di documento) mentre UploadPdI usa un unico DataContract generico per l’upload fornendo solamente 4 dictionary nei quali inserire i metadati tipici di ogni tipologia di documento.
Con l’operazione DownloadFile è possibile scaricare i file del PdI o delle notifiche associate.Per poter scaricare un file è necessario passare la coppia IdObject, IdDoc restituita dalle operazioni di ServizioCS.
Il download è un operazione disponibile a tutti gli utenti che hanno accesso al file richiesto.
4.3.1 Operazione: UploadPdIQuesta operazione consente l’invio di PdI al Servizio CCT TeamSystem.
La richiesta va formulata con i seguenti parametri:
Parametri di Input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
UploadPdI oggetto Contiene gli estremi per l’upload del PdI.
Canale stringa Contiene le info sul canale di trasmissione.
SoggettoProduttore oggetto Soggetto che usufruisce del servizio e che può inviare in conservazione documenti propri o di terzi (Soggetti Deleganti) (Vedi Appendicie B).
SoggettoTitolare oggetto Soggetto che deve conservare il documento: coincide col SoggettoProduttore tranne nel caso di Studi o altri che eseguono la conservazione per conto terzi (Vedi Appendice B).
24
Servizio CCTWeb Services – Specifiche Tecniche
SoggettoOrigine oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi (Vedi Appendice B).
SoggettoDestinazione oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.) (Vedi Appendice B).
DatiDocumento oggetto Contiene le informazioni relative al documento da conservare (Vedi Appendice B).
Se la creazione della pubblicazione ha esito positivo la risposta restituisce:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
UploadPdI oggetto Contenitore per le informazioni relative alil PdI (vedi Appendice B).
IdPdI intero Identificativo univoco della del PdI.
IdDoc intero Identificativo univoco del documento allegato alla pubblicazione.
DateCreation data-ora Data e ora in cui il PdI è stato creato all’interno del Servizio CCT.
IdStatus intero Identificativo dello stato corrente del PdI.
StatusName stringa Nome dello stato corrente del PdI.
DateChangeStatus data-ora Data e ora in cui il PdI ha assunto lo stato corrente.
Oppure un errore SOAP.
Il parametro IdPdI è utilizzabile come identificativo univoco in tutte le operazioni che lo richiedono.
25
Servizio CCTWeb Services – Specifiche Tecniche
4.3.2 Operazione: UploadTypedPdIQuesta operazione consente l’invio di PdI al Servizio CCT TeamSystem.
Si differenzia dal metodo UploadPdI in quanto utilizza DataContract tipicizzati contenente i metadati del PdI e non più un unico DataContract con i 4 Dictionary destinati a contenere di volta in volta i metadati specifici di ciascun PdI.
La richiesta va formulata con i seguenti parametri:
Parametri di Input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
UploadPdI oggetto Contiene gli estremi per l’upload del PdI.
Canale stringa Contiene le info sul canale di trasmissione.
SoggettoTitolare oggetto Soggetto che deve conservare il documento: coincide col SoggettoProduttore tranne nel caso di Studi o altri che eseguono la conservazione per conto terzi (Vedi Appendice B).
PdIBase oggetto Contiene le informazioni relative al documento da conservare (Vedi Appendice B).
Il Soggetto produttore del documento da conservare viene automaticamente ricavato in base all’utente che sta effettuando l’operazione, non è quindi più necessario inserire questi dati come invece lo è nella precendete operation UploadPdI.
Il tipo del parametro PdIBase è la classe base PdIBaseDC: a seconda della tipologia di documento che si vuole uplodare occorrerà istanziare la classa dedicata (PdI1001DC, PdI1002DC, PdI1003DC, ecc.).
Si veda l’Appendice B per l’elenco completo delle classi dedicate e quindi l’elenco delle tipologie al momento disponibili.
26
Servizio CCTWeb Services – Specifiche Tecniche
Se la creazione della pubblicazione ha esito positivo la risposta restituisce:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
UploadPdI oggetto Contenitore per le informazioni relative alil PdI (vedi Appendice B).
IdPdI intero Identificativo univoco della del PdI.
IdDoc intero Identificativo univoco del documento allegato alla pubblicazione.
DateCreation data-ora Data e ora in cui il PdI è stato creato all’interno del Servizio CCT.
IdStatus intero Identificativo dello stato corrente del PdI.
StatusName stringa Nome dello stato corrente del PdI.
DateChangeStatus data-ora Data e ora in cui il PdI ha assunto lo stato corrente.
Oppure un errore SOAP.
Il parametro IdPdI è utilizzabile come identificativo univoco in tutte le operazioni che lo richiedono.
27
Servizio CCTWeb Services – Specifiche Tecniche
4.3.3 Operazione: DownloadFileQuesta operazione consente il download del file precedentemente inviato al Servizio CCT TeamSystem.
La richiesta va formulata con i seguenti parametri:
Parametri di Input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
DownloadFile oggetto Contenitore per le informazioni relative al file da scaricare (vedi Appendice B).
IdObject intero Id della pubblicazione (fattura, messaggio o altro che contiene il file).
IdDoc intero Identificativo del file all’interno della pubblicazione.
Se l’utente ha accesso al file richiesto la risposta restituisce:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
FileInfo oggetto Oggetto contenente i metadati del file richiesto ed il file stesso (vedi Appendice B).
oppure un errore SOAP.
28
Servizio CCTWeb Services – Specifiche Tecniche
4.4 Servizio: ServizioCSÈ il Web Service offerto agli utenti per monitorare lo stato dei propri PdI. Offre le seguenti operazioni:
GetPdI GetTypedPdI SearchPdI SearchTypedPdI
Tramite le operazioni GetPdI e GetTypedPdI è possibile monitorare lo stato di un PdI di cui si conosce l’identificativo ed ottenere l’elenco dei file conservati.
In assenza dell’IdPdI è comunque sempre possibile ottenere l’elenco dei PdI presenti sul sistema tramite le operazioni SearchPdI e SearchTypedPdI che restituisce un elenco paginato dei PdI caricati dall’utente. L’operazione accetta alcuni parametri di ricerca per ottenere un elenco mirato.
Le due OperationContract “Typed” ritornano DataContract tipicizzati mentri le altre due ritornano un DataContract generico con solo 4 dictionary contenenti i metadati tipici di ogni tipologia di documento.
4.4.1 Operazione: GetPdIConsente di recuperare le informazioni relative ad un PdI inviato dall’utente.
Parametri di Input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
IdPdI intero Identificativo del PdI di cui si vuole recuperare lo stato.
DownloadFile booleano
Flag che indica se scaricare o meno il file mandato in conservazione.
Se il PdI risulta valida la risposta restituisce l’oggetto GetPdIOutputDC:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
29
Servizio CCTWeb Services – Specifiche Tecniche
InfoPdI oggetto Contenitore per i dati del PdI indicato (Vedi Appendice B).
oppure un errore SOAP.
4.4.2 Operazione: GetTypedPdIConsente di recuperare le informazioni relative ad un PdI inviato dall’utente.
Parametri di Input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
IdPdI intero Identificativo del PdI di cui si vuole recuperare lo stato.
DownloadFile booleano
Flag che indica se scaricare o meno il file mandato in conservazione.
Se il PdI risulta valida la risposta restituisce l’oggetto GetPdIOutputDC – GetTypedPdI:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
InfoTypedPdI oggetto Contenitore per i dati del PdI indicato (Vedi Appendice B).
oppure un errore SOAP.
30
Servizio CCTWeb Services – Specifiche Tecniche
4.4.3 Operazione: SearchPdIConsente di recuperare le informazioni relative ad un PdI inviato dall’utente.
Parametri di input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
SearchExpression oggetto Contenitore per le clausole di ricerca (Vedi Appendice B).
OrderBy oggetto Contenitore per le clausole di ordinamento (Vedi Appendice B).
PageSize intero Dimensione della pagina di dati richiesta
PageNumber intero Numero della pagina di dati richiesta
Per avere la massima flessibilità nelle ricerche sono previsti un oggetto di ricerca e un oggetto di ordinamento generici (vedasi appendice B).
La ricerca restituisce sempre risultati paginati in modo da limitare il più possibile il rischio di incappare in timeout del servizio causati dal recupero di una grande quantità di dati. I parametri PageSize e PageNumber indicano rispettivamente il numero di record che si desidera ricevere come risultato per pagina mentre PageNumber indica il numero di pagina richiesto.
PageSize ammette valori compresi tra 1 e 10: è quindi possibile chiedere come risultato dell’espressione di ricerca da un minimo di 1 record ad un massimo di 10 (valori esterni a tale range saranno quindi ricondotti all’interno di esso: PageNumber < 1 verrà rivalorizzato a 1, PageNumber > 10 verrà rivalorizzato a 10).
PageNumber ammette valori a partire da 0: la paginazione parte da 1, inserendo il valore 0 viene restituito il numero di record totali (parametro di ritorno RecordCount) e l’ultimo record ricavato dall’espressione di ricerca (il valore PageSize impostato viene quindi ignorato).
ATTENZIONE: con PageNumber > 0 il valore RecordCount resituito assume valore massimo di 1000, ovvero nel caso in cui la ricerca restituisca (complessivamente) più di 1000 record RecordCount varrà sempre 1000 non fornendo quindi il valore corretto del numero di record totali restituiti dall’espressione di ricerca. Conferma di tale comportamento è il parametro di output PartialRecordCount (presente dalla versione 1.2.0 del servizio) che assume il valore booleano true.
Ad esempio quindi per ciclare su tutte le pagine che soddisfano una determinata espressione di ricerca occorre:
- chiamare SearchFE con PageNumber a 0 in modo da ottenere il numero totale di record (RecordCount);
- chiamare SearchFE col PageSize desiderato impostando PageNumber dal valore 1 a RecordCount / PageSize + RecordCount % PageSize.
31
Servizio CCTWeb Services – Specifiche Tecniche
I filtri di ricerca che utilizzano SearchExpression e OrderBy specificano di volta in volta i nomi dei campi (FieldName) utilizzabili nella ricerca o nell’ordinamento.
Questo approccio sacrifica la possibilità dell’utente di utilizzare l’intellisense per i parametri di ricerca ma riduce al minimo le modifiche necessarie ad introdurre nuovi campi. L’operazione controlla sempre che i campi specificati siano validi e la richiesta è rifiutata se in SearchExpression o OrderBy compaiono campi diversi da quelli elencati.
Per tutti i parametri di ricerca elencati è possibile specificare condizioni di ricerca in termini di valore del campo, campo compreso in intervalli specificati, ecc. Il tipo del campo indica il prefisso per gli operatori nelle clausole di ricerca.
All’atto della richiesta viene verificato che l’utente abbia specificato nelle clausole di ricerca e ordinamento solo campi accettati dall’operazione invocata. Se la richiesta è valida viene restituita una risposta con l’elenco dei PdI trovate nel formato:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
ElencoInfoPdI elenco Elenco di oggetti InfoPdI (vedi sopra o in Appendice B)
PageSize intero Dimesione della pagina restituita.
PageCount intero Numero di pagine totali restituite dalla ricerca.
RecordCount intero Numero di record totali restituiti dalla ricerca.
PartialRecordCount booleano Flag che indica se il valore RecordCount corrisponda o meno al numero totale di record restituito dalla ricerca.
Oppure un errore SOAP.
32
Servizio CCTWeb Services – Specifiche Tecniche
4.4.4 Operazione: SearchTypedPdIConsente di recuperare le informazioni relative ad un PdI inviato dall’utente.
Parametri di input Tipo Descrizione
UserIdentity oggetto Contiene l’identità dell’utente (vedi Appendice B).
SearchExpression oggetto Contenitore per le clausole di ricerca (Vedi Appendice B).
OrderBy oggetto Contenitore per le clausole di ordinamento (Vedi Appendice B).
PageSize intero Dimensione della pagina di dati richiesta
PageNumber intero Numero della pagina di dati richiesta
Per avere la massima flessibilità nelle ricerche sono previsti un oggetto di ricerca e un oggetto di ordinamento generici (vedasi appendice B).
La ricerca restituisce sempre risultati paginati in modo da limitare il più possibile il rischio di incappare in timeout del servizio causati dal recupero di una grande quantità di dati. I parametri PageSize e PageNumber indicano rispettivamente il numero di record che si desidera ricevere come risultato per pagina mentre PageNumber indica il numero di pagina richiesto.
PageSize ammette valori compresi tra 1 e 10: è quindi possibile chiedere come risultato dell’espressione di ricerca da un minimo di 1 record ad un massimo di 10 (valori esterni a tale range saranno quindi ricondotti all’interno di esso: PageNumber < 1 verrà rivalorizzato a 1, PageNumber > 10 verrà rivalorizzato a 10).
PageNumber ammette valori a partire da 0: la paginazione parte da 1, inserendo il valore 0 viene restituito il numero di record totali (parametro di ritorno RecordCount) e l’ultimo record ricavato dall’espressione di ricerca (il valore PageSize impostato viene quindi ignorato).
ATTENZIONE: con PageNumber > 0 il valore RecordCount resituito assume valore massimo di 1000, ovvero nel caso in cui la ricerca restituisca (complessivamente) più di 1000 record RecordCount varrà sempre 1000 non fornendo quindi il valore corretto del numero di record totali restituiti dall’espressione di ricerca. Conferma di tale comportamento è il parametro di output PartialRecordCount (presente dalla versione 1.2.0 del servizio) che assume il valore booleano true.
Ad esempio quindi per ciclare su tutte le pagine che soddisfano una determinata espressione di ricerca occorre:
- chiamare SearchFE con PageNumber a 0 in modo da ottenere il numero totale di record (RecordCount);
- chiamare SearchFE col PageSize desiderato impostando PageNumber dal valore 1 a RecordCount / PageSize + RecordCount % PageSize.
33
Servizio CCTWeb Services – Specifiche Tecniche
I filtri di ricerca che utilizzano SearchExpression e OrderBy specificano di volta in volta i nomi dei campi (FieldName) utilizzabili nella ricerca o nell’ordinamento.
Questo approccio sacrifica la possibilità dell’utente di utilizzare l’intellisense per i parametri di ricerca ma riduce al minimo le modifiche necessarie ad introdurre nuovi campi. L’operazione controlla sempre che i campi specificati siano validi e la richiesta è rifiutata se in SearchExpression o OrderBy compaiono campi diversi da quelli elencati.
Per tutti i parametri di ricerca elencati è possibile specificare condizioni di ricerca in termini di valore del campo, campo compreso in intervalli specificati, ecc. Il tipo del campo indica il prefisso per gli operatori nelle clausole di ricerca.
I campi di ordinamento accettati:
Nome Descrizione
IdPdI Identificativo univoco della pubblicazione che contiene il messaggio restituito da SdI.
DateCreation È la data di creazione del PdI
IdStatus Identificativo dello stato corrente del PdI.
DateChangeStatus Data e ora in cui il PdI ha assunto lo stato corrente.
Si noti che non sono riportati i tipi dei campi accettati perché l’ordinamento è sempre formulato indicando se ascendente ASC o discendente DESC, è possibile specificare più campi di ordinamento nell’ordine desiderato con le stesse regole previste dall’SQL.
All’atto della richiesta viene verificato che l’utente abbia specificato nelle clausole di ricerca e ordinamento solo campi accettati dall’operazione invocata. Se la richiesta è valida viene restituita una risposta con l’elenco dei PdI trovate nel formato:
Parametri di Output Tipo Descrizione
ServiceInfo oggetto Oggetto contenente la versione corrente del Servizio ed eventuali informazioni aggiuntive (vedi Appendice B).
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValueDC contenenti eventuali informazioni aggiuntive relative all’operazione corrente (vedi Appendice B).
ElencoInfoPdI elenco Elenco di oggetti InfoPdI (vedi sopra o in Appendice B)
PageSize intero Dimesione della pagina restituita.
PageCount intero Numero di pagine totali restituite dalla ricerca.
34
Servizio CCTWeb Services – Specifiche Tecniche
RecordCount intero Numero di record totali restituiti dalla ricerca.
PartialRecordCount booleano Flag che indica se il valore RecordCount corrisponda o meno al numero totale di record restituito dalla ricerca.
Oppure un errore SOAP.
35
Servizio CCTWeb Services – Specifiche Tecniche
5 Workflow del PdIWorkflow interno delle Fatture Elettroniche inviate alle PA
Il workflow attuale per la conservazione sostitutiva gestita dal servizio CCT è descritto dal seguente schema:
Si tratta di uno schema semplificato che per maggiore chiarezza non riporta alcune transizioni di stato che vengono eseguite assegnando al PdI uno stato specifico a fronte di eventi.
La tabella degli stati del workflow dei file da mandare in conservazione è il seguente:
Stati del workflow del PdI
IdStatus
StatusName Tipo Descrizione
4740 Redazione Persistente Editing manuale da parte dell’utente.
4741 Ricezione Transitorio
36
Appendice A
Servizio CCTWeb Services – Specifiche Tecniche
4742 Ricevuto. Transitorio
4743 Annullato Persistente
4744 Scartato Persistente
4745 Acquisito Transitorio
4746 Accodato su PdA Transitorio
4747 Conservato in PdA Persistente
4748 Decorrenza termini
Finale
Gli stati indicati come transitori sono quelli in cui il PdI può cambiare di stato a seguito di elaborazioni da parte del Servizio CCT senza l’intervento di utenti od operatori.
Gli stati persistenti sono quelli in cui il PdI permane a tempo indeterminato fino a che non intervengono un operatore o un utente.
Gli stati finali sono quelli in cui il PdI non può cambiare di stato.
37
Servizio CCTWeb Services – Specifiche Tecniche
6 Parametri di tipo oggettoRaccolta completa dei parametri di tipo oggetto
Questa appendice raccoglie le tabelle di tutti i parametri di tipo oggetto utilizzati nelle operazioni esposte dai servizi. Gli oggetti sono elencati nell’ordine in cui sono stati presentati nella documentazione.
6.1 ServiceInfoÈ la classe base utilizzata da tutti i metodi dei servizi per restituire informazioni sul servizio stesso ed eventuali info aggiuntive.
ServiceInfo: Tipo Descrizione
ServiceVersion stringa Versione corrente del servizio.
Info elenco Elenco di oggetti di tipo NameValue contenente eventuali informazioni aggiuntive a fronte di richieste opzionali dell’utente.
6.2 NameValueÈ la classe contenente le info aggiuntive che l’utente può inviare o ricevere ai/dai servizi: essendo in ServiceInfo è presente in tutte le risposte dei Web Services mentre per le richieste a è presente nella classe UserIdentity.
NameValue: Tipo Descrizione
Name stringa Nome dell’informazione aggiuntiva inviata/richiesta.
Value stringa Valore dell’informazione aggiuntiva inviata/richiesta.
38
Appendice B
Servizio CCTWeb Services – Specifiche Tecniche
6.3 BaseUserIdentityÈ la classe base contenente le informazioni legate all’identità dell’utente necessarie a tutte le richieste effettuate ai Web Services.
BaseUserIdentity: Tipo Descrizione
Username stringa nome utente (non importa se LowerCase oppure no).
Options elenco Elenco di oggetti di tipo NameValue contenente eventuali richieste opzionali dell’utente.
6.4 UserIdentityÈ la classe che aggiunge informazioni a BaseUserIdentity legate all’identità dell’utente necessarie a tutte le richieste effettuate ai Web Services.
Attualmente contiene solamente il valore del SecurityToken in più a BaseUserIdenty.
UserIdentity: Tipo Descrizione
SecurityToken stringa Nome utente (non importa se LowerCase oppure no).
6.5 BasicAuthenticationÈ il contenitore utilizzato per le informazioni richieste dall’autenticazione di base.
BasicAuthentication: Tipo Descrizione
UserName stringa nome utente (non importa se LowerCase oppure no)
Password stringa password
6.6 DigestAuthenticationÈ il contenitore utilizzato per le informazioni richieste dall’autenticazione fatta con l’algoritmo di hashing SHA1 come descritta nel capitolo dedicato.
DigestAuthentication: Tipo Descrizione
UserName stringa Nome utente (non importa se LowerCase oppure no).
Ticket stringa Ticket fornito dall’operazione GetTicket.
Digest stringa Calcolato con la formula indicata nel capitolo dedicato.
39
Servizio CCTWeb Services – Specifiche Tecniche
6.7 SoggettoProduttore, SoggettoTitolare È il contenitore per i dati relativi ai vari soggetti.
UploadPdI: Tipo Descrizione
IdPaese stringa(2) Codice del Paese nello standard ISO 3166 alpha-2.Parametro obbligatorio.
PartitaIVA stringa(50) Partita IVA del soggetto (lunghezza massima 50 caratteri).
CodiceFiscale stringa Codice fiscale del soggetto.Parametro obbligatorio.
Denominazione stringa Denominazione del soggetto.Parametro obbligatorio quando Nome e Cognome non sono valorizzati.
Nome stringa Nome del soggetto.Parametro obbligatorio quando è valorizzato Cognome.
Cognome stringa Cognome del soggetto.Parametro obbligatorio quando è valorizzato Nome.
6.8 SoggettoOrigine, SoggettoDestinazioneÈ il contenitore per i dati relativi ai vari soggetti.
UploadPdI: Tipo Descrizione
IdPaese stringa(2) Codice del Paese nello standard ISO 3166 alpha-2.
PartitaIVA stringa(50) Partita IVA del soggetto (lunghezza massima 50 caratteri).
CodiceFiscale stringa Codice fiscale del soggetto.
Denominazione stringa Denominazione del soggetto.
Nome stringa Nome del soggetto.
Cognome stringa Cognome del soggetto.
L’obbligatorietà condizionale sui campi viene effettuata solo per i seguenti tipi di documento:
- 1001: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA- 1003: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA- 2001: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA- 2002: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA- 2005: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA
40
Servizio CCTWeb Services – Specifiche Tecniche
- 2007: obbligatorio il CodiceFiscale oppure IdPaese e PartitaIVA
6.9 DatiDocumentoÈ il contenitore dei dati relativi al documento da conservare
InfoPdI: Tipo Descrizione
IdTipoDocumento intero Tipo di documento da conservare.Parametro obbligatorio.
FileType enumeratore Tipo del file (valori elencati nell’Appendice C).Parametro obbligatorio.
HashType enumeratore Tipo del di hash del file (valori elencati nell’Appendice C).Parametro obbligatorio.
HashValue stringa Valore dell’hash del file.Parametro obbligatorio.
FileName stringa Nome del file.Parametro obbligatorio.
FileSize stringa Dimensione del file.Parametro obbligatorio.
FileContent file File del PdI.Parametro obbligatorio.
Esercizio intero Esercizio del file da conservare.Parametro obbligatorio nel caso in cui il file inviato non sia una notifica (IdTipoDocumento 1005).
DataOra1 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value data-ora Valore opzionale da conservare.
DataOra2 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value data-ora Valore opzionale da conservare.
DataOra3 oggetto Oggetto contenente valori opzionali da conservare.
41
Servizio CCTWeb Services – Specifiche Tecniche
Name stringa Etichetta del valore opzionale da conservare.
Value data-ora Valore opzionale da conservare.
Testo1 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value stringa Valore opzionale da conservare.
Testo2 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value stringa Valore opzionale da conservare.
Testo3 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value stringa Valore opzionale da conservare.
Intero1 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value intero Valore opzionale da conservare.
Intero2 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value intero Valore opzionale da conservare.
Intero3 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value intero Valore opzionale da conservare.
Decimale1 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value decimale Valore opzionale da conservare.
Decimale2 oggetto Oggetto contenente valori opzionali da
42
Servizio CCTWeb Services – Specifiche Tecniche
conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value intero Valore opzionale da conservare.
Decimale3 oggetto Oggetto contenente valori opzionali da conservare.
Name stringa Etichetta del valore opzionale da conservare.
Value intero Valore opzionale da conservare.
AdditionalStringParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalIntParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalDateTimeParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalDecimalParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
Di seguito gli IdTipoDocumenti ammessi e i relativi valori addizionali consentiti.
1001: FatturaPA emessa Tipo Descrizione
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
NumeroDocumento stringa Numero con cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
ChiaveAssociazione stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceDestinatarioIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
IdentificativoSdI stringa Codice attribuito dallo SdI alla fattura PA.
43
Servizio CCTWeb Services – Specifiche Tecniche
1002: FatturaPA ricevuta Tipo Descrizione
CodiceDestinatarioIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
ChiaveAssociazione stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
NumeroFatturaOrigine stringa Numero con cui il origine ha emesso il documento.
DataEmissioneOrigine data-ora Data in cui il origine ha emesso il documento.
NumeroProtocollo stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocollo data-ora Data di protocollo informatico attribuito dall’ente pubblico.
1003: Lotto FatturaPA emesso
Tipo Descrizione
ChiaveAssociazione stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
CodiceDestinatarioIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
IdentificativoSdI stringa Codice attribuito dallo SdI alla fattura PA.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
1004: Lotto FatturaPA ricevuto
Tipo Descrizione
ChiaveAssociazione stringa Nome originario del file di fatturaPA inviato allo SDI.
44
Servizio CCTWeb Services – Specifiche Tecniche
Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
CodiceDestinatarioIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
IdentificativoSdI stringa Codice attribuito dallo SdI alla fattura PA.
NumeroProtocollo stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocollo data-ora Data di protocollo informatico attribuito dall’ente pubblico.
1005: Notifica FatturaPA Tipo Descrizione
ChiaveAssociazione stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.
2001: Fattura emessa Tipo Descrizione
NumeroDocumento stringa Numero con cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
45
Servizio CCTWeb Services – Specifiche Tecniche
2002: Nota di variazione emessa
Tipo Descrizione
NumeroDocumento stringa Numero con cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
Sezionale stringa umero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
2003: Fattura ricevuta Tipo Descrizione
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documentoParametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
NumeroFatturaOrigine stringa Numero con cui il origine ha emesso il documento.
DataEmissioneOrigine data-ora Data in cui il origine ha emesso il documento.
2004: Nota di variazione ricevuta
Tipo Descrizione
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documentoParametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di
46
Servizio CCTWeb Services – Specifiche Tecniche
appartenenza di un documento o di un registro IVA.
NumeroFatturaOrigine stringa Numero con cui il origine ha emesso il documento.
DataEmissioneOrigine data-ora Data in cui il origine ha emesso il documento.
2005: DDT emesso Tipo Descrizione
NumeroDocumento stringa Numero con cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
2006: DTT ricevuto Tipo Descrizione
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
NumeroFatturaOrigine stringa Numero con cui il origine ha emesso il documento.
DataEmissioneOrigine data-ora Data in cui il origine ha emesso il documento.
2007: Bolla emessa Tipo Descrizione
NumeroDocumento stringa Numero con cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
Sezionale stringa umero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
DataDocumento data-ora Data in cui è stato emesso il documento dal soggetto emittente.Parametro obbligatorio.
47
Servizio CCTWeb Services – Specifiche Tecniche
48
Servizio CCTWeb Services – Specifiche Tecniche
2008: Bolla ricevuta Tipo Descrizione
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
NumeroFatturaOrigine stringa Numero con cui il origine ha emesso il documento.
DataEmissioneOrigine data-ora Data in cui il origine ha emesso il documento.
2009: Libro giornale Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell’ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
2010: Registro IVA Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell’ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
49
Servizio CCTWeb Services – Specifiche Tecniche
2011: Libro Mastro Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell’ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
2012: Libro cespiti Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell’ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
2013: Giornale di magazzino
Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell’ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
50
Servizio CCTWeb Services – Specifiche Tecniche
2014: Registro di Protocollo Informatico
Tipo Descrizione
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
CodiceIPA stringa Codice Identificativo Amministrazione Titolare
DenominazioneAmministrazione
stringa
CodiceAOO stringa Codice Identificativo Area Organizzativa Omogenea
ResponsabileRegistro stringa Cognome, Nome, Codice Fiscale
CodiceIdentificativoRegistro stringa Codice Identificativo del Registro
NumeroProgressivoRegistro stringa
DataCreazioneRegistro data-ora
NumeroPrimaRegistrazione stringa
NumeroUltimaRegistrazione stringa
DataPrimaRegistrazione data-ora
DataUltimaRegistrazione data-ora
2015: Libro inventari Tipo Descrizione
PaginaIniziale numero Numero della prima pagina.
PaginaFinale numero Numero dell’ultima pagina.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa Tipo di libro inventari.
51
Servizio CCTWeb Services – Specifiche Tecniche
6.10PdIBaseÈ il data contract di base dal quale quelli specifici dei vari tipi di documento derivano.
PdIBase: Tipo Descrizione
HashType enumeratore Tipo del di hash del file (valori elencati nell’Appendice C).Parametro obbligatorio.
HashValue stringa Valore dell’hash del file.Parametro obbligatorio.
FileName stringa Nome del file.Parametro obbligatorio.
FileSize stringa Dimensione del file.Parametro obbligatorio.
FileContent file File del PdI.Parametro obbligatorio.
DataOra1 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra2 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra3 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
Decimale1 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Decimale2 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
52
Servizio CCTWeb Services – Specifiche Tecniche
Decimale3 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero1 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero2 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero3 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo1 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo2 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo3 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
6.11PdI1001È il data contract deputato all’upload di PdI con codice 1001 (FatturaPA emessa).
53
Servizio CCTWeb Services – Specifiche Tecniche
PdI1001 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)Parametro obbligatorio.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione della fattura.Parametro obbligatorio.
NumeroFattura stringa Numero della fattura.Parametro obbligatorio.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
CodiceSdI stringa Codice attribuito dallo SdI alla fattura PA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni: PdIFileType.xml, PdIFileType.xml_p7m
54
Servizio CCTWeb Services – Specifiche Tecniche
6.12PdI1002È il data contract deputato all’upload di PdI con codice 1002 (FatturaPA ricevuta).
PdI1002 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.Parametro obbligatorio.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
NumeroProtocolloInformatico stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocolloInformatico data-ora Data di protocollo informatico attribuito dall’ente pubblico.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.xml, PdIFileType.xml_p7m
55
Servizio CCTWeb Services – Specifiche Tecniche
6.13PdI1003È il data contract deputato all’upload di PdI con codice 1003 (Lotto FatturaPA emesso).
PdI1003 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.).Parametro obbligatorio.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione del lotto.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
CodiceSdI stringa Codice attribuito dallo SdI alla fattura PA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.xml, PdIFileType.xml_p7m
56
Servizio CCTWeb Services – Specifiche Tecniche
6.14PdI1004È il data contract deputato all’upload di PdI con codice 1004 (Lotto FatturaPA ricevuto).
PdI1004 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
NumeroProtocolloInformatico stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocolloInformatico data-ora Data di protocollo informatico attribuito dall’ente pubblico.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell’ente pubblico a cui è destinata la fatturaPA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.xml, PdIFileType.xml_p7m
57
Servizio CCTWeb Services – Specifiche Tecniche
6.15PdI1005È il data contract deputato all’upload di PdI con codice 1005 (Lotto FatturaPA ricevuto).
PdI1005 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.Parametro obbligatorio.
DataDocumento data-ora Data in cui è stato emesso il documento.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.xml, PdIFileType.xml_p7m
58
Servizio CCTWeb Services – Specifiche Tecniche
6.16PdI2001È il data contract deputato all’upload di PdI con codice 2001 (Fattura emessa).
PdI2001 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.).Parametro obbligatorio.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione della fattura.Parametro obbligatorio.
NumeroFattura stringa Numero della fatturaParametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceDestinatario stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml, PdIFileType.xml_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
59
Servizio CCTWeb Services – Specifiche Tecniche
6.17PdI2002È il data contract deputato all’upload di PdI con codice 2002 (Nota di variazione emessa).
PdI2002 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.).Parametro obbligatorio.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione del documento.Parametro obbligatorio.
NumeroNota stringa Numero della nota.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceDestinatario stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml, PdIFileType.xml_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
60
Servizio CCTWeb Services – Specifiche Tecniche
6.18PdI2003È il data contract deputato all’upload di PdI con codice 2003 (Fattura ricevuta).
PdI2003 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.Parametro obbligatorio.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.Parametro obbligatorio.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceDestinatario stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensoni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
61
Servizio CCTWeb Services – Specifiche Tecniche
6.19PdI2004 È il data contract deputato all’upload di PdI con codice 2004 (Nota di variazione ricevuta).
PdI2004 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.Parametro obbligatorio.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.Parametro obbligatorio.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceDestinatario stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml, PdIFileType.xml_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
62
Servizio CCTWeb Services – Specifiche Tecniche
6.20PdI2005È il data contract deputato all’upload di PdI con codice 2005 (DDT emesso).
PdI2005 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.).
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione del documento.Parametro obbligatorio.
NumeroDDT stringa Numero del DDT.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml,PdIFileType.xml_p7m,PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
63
Servizio CCTWeb Services – Specifiche Tecniche
6.21PdI2006È il data contract deputato all’upload di PdI con codice 2006 (DDT ricevuto).
PdI2006 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroDocumentoFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
64
Servizio CCTWeb Services – Specifiche Tecniche
6.22PdI2007È il data contract deputato all’upload di PdI con codice 2007 (Bolla emessa).
PdI2007 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.).Parametro obbligatorio.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataEmissione data-ora Data di emissione del documento.Parametro obbligatorio.
NumeroBolla stringa Numero della bolla.Parametro obbligatorio.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
65
Servizio CCTWeb Services – Specifiche Tecniche
6.23PdI2008È il data contract deputato all’upload di PdI con codice 2008 (Bolla ricevuta).
PdI2008 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroDocumentoFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
66
Servizio CCTWeb Services – Specifiche Tecniche
6.24PdI2009È il data contract deputato all’upload di PdI con codice 2009 (Libro giornale).
PdI2009 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.txt,PdIFileType.txt_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg,PdIFileType.jpg_p7m
67
Servizio CCTWeb Services – Specifiche Tecniche
6.25PdI2010È il data contract deputato all’upload di PdI con codice 2010 (Registro IVA).
2010: Registro IVA Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).Parametro obbligatorio.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.txt, PdIFileType.txt_p7m, PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
68
Servizio CCTWeb Services – Specifiche Tecniche
6.26PdI2011È il data contract deputato all’upload di PdI con codice 2011 (Libro mastro).
PdI2011 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.txt, PdIFileType.txt_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
69
Servizio CCTWeb Services – Specifiche Tecniche
6.27PdI2012È il data contract deputato all’upload di PdI con codice 2012 (Libro cespiti).
2012: Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.txt, PdIFileType.txt_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
70
Servizio CCTWeb Services – Specifiche Tecniche
6.28PdI2013È il data contract deputato all’upload di PdI con codice 2012 (Giornale di magazzino).
PdI2013 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.txt, PdIFileType.txt_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
71
Servizio CCTWeb Services – Specifiche Tecniche
6.29PdI2014È il data contract deputato all’upload di PdI con codice 2014 (Registro di Protocollo Informatico).
PdI2014 Tipo Descrizione
AnnoRegistro intero Anno del registro.Parametro obbligatorio.
CodiceIPA stringa Codice Identificativo Amministrazione Titolare
DenominazioneAmministrazione stringa
CodiceAOO stringa Codice Identificativo Area Organizzativa Omogenea
ResponsabileRegistro stringa Cognome, Nome, Codice Fiscale
CodiceIdentificativoRegistro stringa Codice Identificativo del Registro
NumeroProgressivoRegistro stringa
DataCreazioneRegistro data-ora
NumeroPrimaRegistrazione stringa
NumeroUltimaRegistrazione stringa
DataPrimaRegistrazione data-ora
DataUltimaRegistrazione data-ora
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.xml,PdIFileType.xml_p7m, PdIFileType.txt, PdIFileType.txt_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,
72
Servizio CCTWeb Services – Specifiche Tecniche
PdIFileType.jpg, PdIFileType.jpg_p7m
73
Servizio CCTWeb Services – Specifiche Tecniche
6.30PdI2015È il data contract deputato all’upload di PdI con codice 2015 (Libro inventari).
PdI2015 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
PaginaIniziale numero Numero della prima pagina.
PaginaFinale numero Numero dell'ultima pagina.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.txt, PdIFileType.txt_p7m, PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
74
Servizio CCTWeb Services – Specifiche Tecniche
6.31PdI2016È il data contract deputato all’upload di PdI con codice 2016 (Bilancio d'esercizio).
PdI2016 Tipo Descrizione
EsercizioFiscale intero Esercizio del file da conservare.Parametro obbligatorio.
DenominazioneSoggetto stringa Soggetto a cui si riferisce il bilancio d’esercizio.
DescrizioneDocumento stringa Utile ad esempio per indicare che si tratta del file nota integrativa rispetto al file relazione sulla gestione, ecc.
DataTrasmissioneTelematica data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.xbrl,PdIFileType.xbrl_p7m,PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
75
Servizio CCTWeb Services – Specifiche Tecniche
6.32PdI2017È il data contract deputato all’upload di PdI con codice 2017 (Dichiarazioni Unico persone fisiche).
PdI2017 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
76
Servizio CCTWeb Services – Specifiche Tecniche
6.33PdI2018È il data contract deputato all’upload di PdI con codice 2018 (Dichiarazioni Unico società di persone).
PdI2018 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
77
Servizio CCTWeb Services – Specifiche Tecniche
6.34PdI2019È il data contract deputato all’upload di PdI con codice 2019 (Dichiarazioni Unico società di capitali).
PdI2019 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m, PdIFileType.jpeg,PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
78
Servizio CCTWeb Services – Specifiche Tecniche
6.35PdI2020È il data contract deputato all’upload di PdI con codice 2020 (Dichiarazioni Unico enti non commerciali).
PdI2020 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
79
Servizio CCTWeb Services – Specifiche Tecniche
6.36PdI2021È il data contract deputato all’upload di PdI con codice 2021 (Allegati dichiarazioni modello Unico).
PdI2021 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
80
Servizio CCTWeb Services – Specifiche Tecniche
6.37PdI2022È il data contract deputato all’upload di PdI con codice 2022 (Dichiarazioni IRAP).
PdI2022 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
81
Servizio CCTWeb Services – Specifiche Tecniche
6.38PdI2023È il data contract deputato all’upload di PdI con codice 2023 (Dichiarazioni 730).
PdI2023 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
82
Servizio CCTWeb Services – Specifiche Tecniche
6.39PdI2024È il data contract deputato all’upload di PdI con codice 2024 (Allegati dichiarazioni 730).
PdI2024 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
83
Servizio CCTWeb Services – Specifiche Tecniche
6.40PdI2025È il data contract deputato all’upload di PdI con codice 2025 (Dichiarazioni 730 precompilato).
PdI2025 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg,PdIFileType.jpg_p7m
84
Servizio CCTWeb Services – Specifiche Tecniche
6.41PdI2026È il data contract deputato all’upload di PdI con codice 2026 (Allegati dichiarazioni 730 precompilato).
PdI2026 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
85
Servizio CCTWeb Services – Specifiche Tecniche
6.42PdI2027È il data contract deputato all’upload di PdI con codice 2027 (Dichiarazioni 730/4).
PdI2027 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
TipoComunicazione stringa
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
86
Servizio CCTWeb Services – Specifiche Tecniche
6.43PdI2028È il data contract deputato all’upload di PdI con codice 2028 (Dichiarazioni consolidato nazionale e mondiale).
PdI2028 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
87
Servizio CCTWeb Services – Specifiche Tecniche
6.44PdI2029È il data contract deputato all’upload di PdI con codice 2029 (Dichiarazioni IVA).
PdI2029 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni: PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
88
Servizio CCTWeb Services – Specifiche Tecniche
6.45PdI2030È il data contract deputato all’upload di PdI con codice 2030 (Comunicazione annuale dati IVA).
PdI2030 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
89
Servizio CCTWeb Services – Specifiche Tecniche
6.46PdI2031È il data contract deputato all’upload di PdI con codice 2031 (Prospetto delle liquidazioni periodiche dell'IVA).
PdI2031 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
90
Servizio CCTWeb Services – Specifiche Tecniche
6.47PdI2032È il data contract deputato all’upload di PdI con codice 2032 (Dichiarazioni IVA 74 bis).
PdI2032 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
91
Servizio CCTWeb Services – Specifiche Tecniche
6.48PdI2033È il data contract deputato all’upload di PdI con codice 2033 (Dichiarazioni IVA 26).
PdI2033 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataTrasmissione data-ora
TipoDichiarazione stringa
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
92
Servizio CCTWeb Services – Specifiche Tecniche
6.49PdI2034È il data contract deputato all’upload di PdI con codice 2034 (Dichiarazioni 770 semplificato).
PdI2034 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
93
Servizio CCTWeb Services – Specifiche Tecniche
6.50PdI2035È il data contract deputato all’upload di PdI con codice 2035 (Dichiarazioni 770 ordinario).
PdI2035 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
94
Servizio CCTWeb Services – Specifiche Tecniche
6.51PdI2036È il data contract deputato all’upload di PdI con codice 2036 (Certificaziona unica).
PdI2036 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
ProtocolloEntratelFisconline stringa
Tipo stringa Tipo di libro inventari.
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
95
Servizio CCTWeb Services – Specifiche Tecniche
6.52PdI2037È il data contract deputato all’upload di PdI con codice 2037 (Incarico per addebito telematico).
PdI2037 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa
DataIncaricoRevoca data-ora
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
96
Servizio CCTWeb Services – Specifiche Tecniche
6.53PdI2038È il data contract deputato all’upload di PdI con codice 2038 (Impegno alla trasmissione telematica).
PdI2038 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa
DataImpegno data-ora
TipoImpegno stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
97
Servizio CCTWeb Services – Specifiche Tecniche
6.54PdI2039È il data contract deputato all’upload di PdI con codice 2039 (Ricevute AE presentazioni telematiche).
PdI2039 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa
DataRicevuta data-ora
TipoRicevuta stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.rcc, PdIFileType.rcc_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
98
Servizio CCTWeb Services – Specifiche Tecniche
6.55PdI2040È il data contract deputato all’upload di PdI con codice 2040 (Studi di settore).
PdI2040 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Contribuente stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif,PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
99
Servizio CCTWeb Services – Specifiche Tecniche
6.56PdI2041È il data contract deputato all’upload di PdI con codice 2041 (Istanze di rimborso IRAP).
PdI2041 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Contribuente stringa
ModalitaTrasmissione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
100
Servizio CCTWeb Services – Specifiche Tecniche
6.57PdI2042È il data contract deputato all’upload di PdI con codice 2042 (Scheda destinazione 8 - 5 - 2 per mille).
PdI2042 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
Contribuente stringa
ModalitaTrasmissione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
101
Servizio CCTWeb Services – Specifiche Tecniche
6.58PdI2043È il data contract deputato all’upload di PdI con codice 2043 (Domanda iscrizione 5 per mille).
PdI2043 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
Ente stringa
TipoComunicazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
102
Servizio CCTWeb Services – Specifiche Tecniche
6.59PdI2044È il data contract deputato all’upload di PdI con codice 2044 (Dichiarazione di intento).
PdI2044 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
ProtocolloEntratelFisconline stringa
DataTrasmissione data-ora
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff, PdIFileType.tiff_p7m, PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
103
Servizio CCTWeb Services – Specifiche Tecniche
6.60PdI2045È il data contract deputato all’upload di PdI con codice 2045 (Modelli F24).
PdI2045 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
DataVersamento data-ora
Contribuente stringa
SezioniF24 stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.fcf,PdIFileType.fcf_p7m, PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
104
Servizio CCTWeb Services – Specifiche Tecniche
6.61PdI2046È il data contract deputato all’upload di PdI con codice 2046 (Modelli F23).
PdI2046 Tipo Descrizione
Anno intero Esercizio del file da conservare.Parametro obbligatorio.
DataVersamento data-ora
Contribuente stringa
CodiciTributo stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.fcf,PdIFileType.fcf_p7m,PdIFileType.tif,PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg, PdIFileType.jpg_p7m
105
Servizio CCTWeb Services – Specifiche Tecniche
6.62PdI2047È il data contract deputato all’upload di PdI con codice 2047 (Comunicazione polivalente).
PdI2047 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
PeriodoRiferimentoMeseTrimestre stringa
DestinatarioComunicazione stringa
OrigineComunicazione stringa
Tipo stringa
TipologiaComunicazione stringa
FormatoComunicazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
106
Servizio CCTWeb Services – Specifiche Tecniche
6.63PdI2048È il data contract deputato all’upload di PdI con codice 2048 (Dichiarazione dell'imposta di bollo (virtuale)).
PdI2048 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
PeriodoRiferimentoTrimestre stringa Parametro obbligatorio se non è valorizzato PeriodoRiferimentoMese.
PeriodoRiferimentoMese Parametro obbligatorio se non è valorizzato PeriodoRiferimentoTrimestre.
SoggettoObbligato stringa
SoggettoDelegato stringa
TipoModello stringa
DataTrasmissione data-ora
ProtocolloServizioTelematicoDoganale stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m}
107
Servizio CCTWeb Services – Specifiche Tecniche
6.64PdI2049È il data contract deputato all’upload di PdI con codice 2049 (Dichiarazione dell'imposta di bollo (virtuale)).
PdI2049 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
PeriodoRiferimentoData data-ora Parametro obbligatorio.
SoggettoDichiarazione stringa
TipoDichiarazione stringa
EstremiAutorizzazione stringa
AnnoRilascioAutorizzazione numero
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m, PdIFileType.ccf,PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
108
Servizio CCTWeb Services – Specifiche Tecniche
6.65PdI2050È il data contract deputato all’upload di PdI con codice 2050 (Comunicazione modelli AA5/AA6).
PdI2050 Tipo Descrizione
AnnoRichiesta intero Esercizio del file da conservare.Parametro obbligatorio.
SoggettoImposta stringa
TipoRichiesta stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.ccf, PdIFileType.ccf_p7m,PdIFileType.tif, PdIFileType.tif_p7m, PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m, PdIFileType.jpg,PdIFileType.jpg_p7m
109
Servizio CCTWeb Services – Specifiche Tecniche
6.66PdI2051È il data contract deputato all’upload di PdI con codice 2051 (Comunicazione modelli AA7/AA9).
PdI2051 Tipo Descrizione
AnnoRichiesta intero Esercizio del file da conservare.Parametro obbligatorio.
SoggettoImposta stringa
TipoDichiarazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.ccf,PdIFileType.ccf_p7m, PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg, PdIFileType.jpeg_p7m,PdIFileType.jpg,PdIFileType.jpg_p7m
110
Servizio CCTWeb Services – Specifiche Tecniche
6.67PdI2052È il data contract deputato all’upload di PdI con codice 2052 (Dichiarazione sostitutiva unica (DSU)).
PdI2052 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
DataSottoscrizioneDSU data-ora
Dichiarante_CognomeNome stringa
Dichiarante_CodiceFiscale stringa
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
111
Servizio CCTWeb Services – Specifiche Tecniche
6.68PdI2053È il data contract deputato all’upload di PdI con codice 2053 (Dichiarazione RED).
PdI2053 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
DataSottoscrizioneModelloRED data-ora
Pensionato_CognomeNome stringa
Pensionato_CodiceFiscale stringa
DataTrasmissione data-ora
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf, PdIFileType.pdf_p7m,PdIFileType.xml, PdIFileType.xml_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff,PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
112
Servizio CCTWeb Services – Specifiche Tecniche
6.69PdI2054È il data contract deputato all’upload di PdI con codice 2054 (Dichiarazione modelli INV.CIV).
PdI2054 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.Parametro obbligatorio.
DataSottoscrizioneModello data-ora
Titolare _CognomeNome stringa
Titolare _CodiceFiscale stringa
DataTrasmissione data-ora
Tipo stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.pdf_p7m,PdIFileType.xml,PdIFileType.xml_p7m,PdIFileType.tif, PdIFileType.tif_p7m,PdIFileType.tiff, PdIFileType.tiff_p7m,PdIFileType.jpeg,PdIFileType.jpeg_p7m,PdIFileType.jpg, PdIFileType.jpg_p7m
6.70PdI2055È il data contract deputato all’upload di PdI con codice 2055 (Log).
PdI2055 Tipo Descrizione
AnnoDelLog intero Esercizio del file da conservare.Parametro obbligatorio.
TipoLog stringa
DataEstrazione data-ora
FileType enumerato Tipo del file (valori elencati nell’Appendice C).
113
Servizio CCTWeb Services – Specifiche Tecniche
Accetta le seguenti estensioni:PdIFileType.pdf,PdIFileType.xml,PdIFileType.txt,PdIFileType.pdf_p7m,PdIFileType.xml_p7m,PdIFileType.txt_p7m
6.71PdI2056È il data contract deputato all’upload di PdI con codice 2056 (Pec).
PdI2056 Tipo Descrizione
AnnoDelMessaggio intero Esercizio del file da conservare.Parametro obbligatorio.
CasellaMail_Pec stringa
DataMessaggio data-ora
OggettoMessaggio stringa
IdMessaggio stringa
TipoMessaggio stringa
MittenteMessaggio stringa
DestinatarioMessaggio stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.eml,PdIFileType.eml_p7m
6.72PdI2057È il data contract deputato all’upload di PdI con codice 2057 (Mail).
PdI2057 Tipo Descrizione
AnnoDelMessaggio intero Esercizio del file da conservare.Parametro obbligatorio.
CasellaMail_Pec stringa
DataMessaggio data-ora
114
Servizio CCTWeb Services – Specifiche Tecniche
OggettoMessaggio stringa
IdMessaggio stringa
TipoMessaggio stringa
MittenteMessaggio stringa
DestinatarioMessaggio stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).Accetta le seguenti estensioni:PdIFileType.eml,PdIFileType.eml_p7m
6.73PdI2058È il data contract deputato all’upload di PdI con codice 2058 (Lotto fatture emesse B2B).
PdI2058 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
DataRegistrazione data-ora
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)Parametro obbligatorio.
CodiceDestinatario stringa
Sezionale stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).PdIFileType.xml,PdIFileType.xml_p7m
6.74PdI2059È il data contract deputato all’upload di PdI con codice 2059 (Lotto fatture ricevute B2B).
PdI2059 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.Parametro obbligatorio.
115
Servizio CCTWeb Services – Specifiche Tecniche
DataRegistrazione data-ora
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
CodiceDestinatario stringa
Sezionale stringa
FileType enumerato Tipo del file (valori elencati nell’Appendice C).PdIFileType.xml,PdIFileType.xml_p7m
6.75InfoPdIÈ il datacontract contenente le informazioni di un PdI restituito all’utente.
InfoPdI: Tipo Descrizione
IdPdI intero Identificativo da utilizzare per referenziare il PdI nelle operazioni che lo richiedono.
DateCreation data-ora Data e ora in cui la pubblicazione che contiene il PdI è stata creata all’interno del Servizio CCT
IdStatus intero Identificativo dello stato corrente del PdI.
StatusName stringa Nome dello stato corrente del PdI.
DateChangeStatus data-ora Data e ora in cui il PdI ha assunto lo stato corrente.
SoggettoProduttore oggetto Soggetto che usufruisce del servizio e che può inviare in conservazione documenti propri o di terzi (Soggetti Deleganti) (Vedi Appendicie B).
SoggettoTitolare oggetto Soggetto che deve conservare il documento: coincide col SoggettoProduttore tranne nel caso di Studi o altri che eseguono la conservazione per conto terzi (Vedi Appendice B).
SoggettoOrigine oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi (Vedi Appendice B).
SoggettoDestinazione oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti
116
Servizio CCTWeb Services – Specifiche Tecniche
che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.) (Vedi Appendice B).
IdTipoDocumento intero Identificativo del tipo di documento da conservare.
Canale stringa Contiene le info sul canale di trasmissione.
Esercizio intero Anno chiusura dell’esercizio.
DataOra1 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra2 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra3 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
Decimale1 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Decimale2 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Decimale3 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero1 oggetto Campo custom contente un valore intero definito dall’utente.
117
Servizio CCTWeb Services – Specifiche Tecniche
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero2 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero3 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo1 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo2 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo3 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
AdditionalStringParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalIntParameters elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalDateTimeParameters
elenco chiave-valore
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
AdditionalDecimalParameters
elenco chiave-
Attributi specifici (obbligatori o meno) relativi allo specifico tipo di documento da conservare.
118
Servizio CCTWeb Services – Specifiche Tecniche
valore
FileInfo oggetto File inviato per la conservazione.
IdStatus e StatusName sono rispettivamente l’identificativo interno e il nome dello stato del Workflow della Conservazione Sostitutiva in Cloud (Vedi Appendice A). TeamSystem si riserva di applicare eventuali variazioni al Workflow (aggiunta o rimozione di stati), tuttavia IdStatus è da considerarsi un valore fisso che identifica con certezza uno stato. StatusName è va invece considerato come una stringa mnemonica associata allo stato ed eventualmente oggetto di modifiche.
6.76InfoTypedPdIÈ il data contract di base contenente le informazioni di un PdI restituito all’utente dal quale quelli specifici dei vari tipi di documento derivano.
InfoPdI: Tipo Descrizione
IdPdI intero Identificativo da utilizzare per referenziare il PdI nelle operazioni che lo richiedono.
DateCreation data-ora Data e ora in cui la pubblicazione che contiene il PdI è stata creata all’interno del Servizio CCT
IdStatus intero Identificativo dello stato corrente del PdI.
StatusName stringa Nome dello stato corrente del PdI.
DateChangeStatus data-ora Data e ora in cui il PdI ha assunto lo stato corrente.
SoggettoProduttore oggetto Soggetto che usufruisce del servizio e che può inviare in conservazione documenti propri o di terzi (Soggetti Deleganti) (Vedi Appendicie B).
SoggettoTitolare oggetto Soggetto che deve conservare il documento: coincide col SoggettoProduttore tranne nel caso di Studi o altri che eseguono la conservazione per conto terzi (Vedi Appendice B).
SoggettoOrigine oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi (Vedi Appendice B).
SoggettoDestinazione oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.) (Vedi Appendice B).
119
Servizio CCTWeb Services – Specifiche Tecniche
IdTipoDocumento intero Identificativo del tipo di documento da conservare.
Canale stringa Contiene le info sul canale di trasmissione.
DataOra1 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra2 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
DataOra3 oggetto Campo custom contente una data definita dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value data-ora Valore del campo custom definito dall’utente.
Decimale1 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Decimale2 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Decimale3 oggetto Campo custom contente un valore decimale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero1 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Intero2 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
120
Servizio CCTWeb Services – Specifiche Tecniche
Value numero Valore del campo custom definito dall’utente.
Intero3 oggetto Campo custom contente un valore intero definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo1 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo2 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
Testo3 oggetto Campo custom contente un valore testuale definito dall’utente.
Name stringa Etichetta del campo custom definito dall’utente.
Value numero Valore del campo custom definito dall’utente.
FileInfo oggetto File inviato per la conservazione.
IdStatus e StatusName sono rispettivamente l’identificativo interno e il nome dello stato del Workflow della Conservazione Sostitutiva in Cloud (Vedi Appendice A). TeamSystem si riserva di applicare eventuali variazioni al Workflow (aggiunta o rimozione di stati), tuttavia IdStatus è da considerarsi un valore fisso che identifica con certezza uno stato. StatusName è va invece considerato come una stringa mnemonica associata allo stato ed eventualmente oggetto di modifiche.
6.77InfoPdI1001È il data contract contenente le informazioni di PdI con codice 1001 (FatturaPA emessa).
InfoPdI1001 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
121
Servizio CCTWeb Services – Specifiche Tecniche
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora Data di emissione della fattura.
NumeroFattura stringa Numero della fattura
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell'ente pubblico a cui è destinata la fatturaPA.
CodiceSdI stringa Codice attribuito dallo SdI alla fattura PA.
6.78InfoPdI1002È il data contract contenente le informazioni di PdI con codice 1002 (FatturaPA ricevuta).
PdI1002 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
NumeroProtocolloInformatico stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocolloInformatico data-ora Data di protocollo informatico attribuito dall’ente pubblico.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
122
Servizio CCTWeb Services – Specifiche Tecniche
CodiceIPA stringa Riferimento univoco dell'ente pubblico a cui è destinata la fatturaPA.
123
Servizio CCTWeb Services – Specifiche Tecniche
6.79InfoPdI1003È il data contract contenente le informazioni di PdI con codice 1003 (Lotto FatturaPA emesso).
PdI1003 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora Data di emissione del lotto.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell'ente pubblico a cui è destinata la fatturaPA.
CodiceSdI stringa Codice attribuito dallo SdI alla fattura PA.
6.80InfoPdI1004È il data contract contenente le informazioni di PdI con codice 1004 (Lotto FatturaPA ricevuto).
PdI1004 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.
NumeroProtocolloInformatico stringa Numero di protocollo informatico attribuito dall’ente pubblico.
DataProtocolloInformatico data-ora Data di protocollo informatico attribuito dall’ente pubblico.
124
Servizio CCTWeb Services – Specifiche Tecniche
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
CodiceIPA stringa Riferimento univoco dell'ente pubblico a cui è destinata la fatturaPA.
6.81InfoPdI1005È il data contract contenente le informazioni di PdI con codice 1005 (Lotto FatturaPA ricevuto).
PdI1005 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
NomeFileOriginale stringa Nome originario del file di fatturaPA inviato allo SDI.
DataDocumento data-ora Data in cui è stato emesso il documento.
6.82InfoPdI2001È il data contract contenente le informazioni di PdI con codice 2001 (Fattura emessa).
PdI2001 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora Data di emissione della fattura.
NumeroFattura stringa Numero della fattura
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
125
Servizio CCTWeb Services – Specifiche Tecniche
6.83InfoPdI2002È il data contract contenente le informazioni di PdI con codice 2002 (Nota di variazione emessa).
PdI2002 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora Data di emissione del documento.
NumeroNota stringa Numero della nota.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
6.84InfoPdI2003È il data contract contenente le informazioni di PdI con codice 2003 (Fattura ricevuta).
PdI2003 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
126
Servizio CCTWeb Services – Specifiche Tecniche
6.85InfoPdI2004 È il data contract contenente le informazioni di PdI con codice 2004 (Nota di variazione ricevuta).
PdI2004 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroFatturaFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
6.86InfoPdI2005È il data contract contenente le informazioni di PdI con codice 2005 (DDT emesso).
PdI2005 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
PeriodoImposta intero Esercizio del file da conservare.
NumeroDDT stringa Numero del DDT.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
127
Servizio CCTWeb Services – Specifiche Tecniche
6.87InfoPdI2006È il data contract contenente le informazioni di PdI con codice 2006 (DDT ricevuto).
PdI2006 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroDocumentoFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
6.88InfoPdI2007È il data contract contenente le informazioni di PdI con codice 2007 (Bolla emessa).
PdI2007 Tipo Descrizione
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora Data di emissione del documento.
NumeroBolla stringa Numero della bolla.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
128
Servizio CCTWeb Services – Specifiche Tecniche
6.89InfoPdI2008È il data contract contenente le informazioni di PdI con codice 2008 (Bolla ricevuta).
PdI2008 Tipo Descrizione
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora Data in cui è stata effettuata la registrazione contabile del documento.
NumeroRegistrazione stringa Numero attribuito alla registrazione contabile del documento.
NumeroDocumentoFornitore stringa Numero con cui l’origine ha emesso il documento.
DataEmissioneFornitore data-ora Data in cui l’origine ha emesso il documento.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
6.90InfoPdI2009È il data contract contenente le informazioni di PdI con codice 2009 (Libro giornale).
PdI2009 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
129
Servizio CCTWeb Services – Specifiche Tecniche
6.91InfoPdI2010È il data contract contenente le informazioni di PdI con codice 2010 (Registro IVA).
2010: Registro IVA Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Sezionale stringa Numero, codice o descrizione del registro sezionale di appartenenza di un documento o di un registro IVA.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).Parametro obbligatorio.
6.92InfoPdI2011È il data contract contenente le informazioni di PdI con codice 2011 (Libro mastro).
PdI2011 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
130
Servizio CCTWeb Services – Specifiche Tecniche
6.93InfoPdI2012È il data contract contenente le informazioni di PdI con codice 2012 (Libro cespiti).
2012: Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
6.94InfoPdI2013È il data contract contenente le informazioni di PdI con codice 2012 (Giornale di magazzino).
PdI2013 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina di un registro o libro contabile.
PaginaFinale numero Numero dell'ultima pagina di un registro o libro contabile.
DataInizio data-ora Data di inizio del periodo di competenza di un registro o libro contabile.
DataFine data-ora Data di fine del periodo di competenza di un registro o libro contabile.
Tipo stringa Tipo di registro o libro contabile (per es. per i registri iva: acquisti o vendite o corrispettivi).
131
Servizio CCTWeb Services – Specifiche Tecniche
6.95InfoPdI2014È il data contract contenente le informazioni di PdI con codice 2014 (Registro di Protocollo Informatico).
PdI2014 Tipo Descrizione
AnnoRegistro intero Anno del registro
CodiceIPA stringa Codice Identificativo Amministrazione Titolare
DenominazioneAmministrazione
stringa
CodiceAOO stringa Codice Identificativo Area Organizzativa Omogenea
ResponsabileRegistro stringa Cognome, Nome, Codice Fiscale
CodiceIdentificativoRegistro stringa Codice Identificativo del Registro
NumeroProgressivoRegistro stringa
DataCreazioneRegistro data-ora
NumeroPrimaRegistrazione stringa
NumeroUltimaRegistrazione stringa
DataPrimaRegistrazione data-ora
DataUltimaRegistrazione data-ora
6.96InfoPdI2015È il data contract contenente le informazioni di PdI con codice 2015 (Libro inventari).
PdI2015 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
PaginaIniziale numero Numero della prima pagina.
PaginaFinale numero Numero dell'ultima pagina.
DataInizio data-ora Data di inizio del periodo di competenza.
132
Servizio CCTWeb Services – Specifiche Tecniche
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa Tipo di libro inventari.
133
Servizio CCTWeb Services – Specifiche Tecniche
6.97InfoPdI2016È il data contract contenente le informazioni di PdI con codice 2016 (Bilancio d'esercizio).
PdI2016 Tipo Descrizione
EsercizioFiscale intero Esercizio del file da conservare.
DenominazioneSoggetto stringa Soggetto a cui si riferisce il bilancio d’esercizio.
DescrizioneDocumento stringa Utile ad esempio per indicare che si tratta del file nota integrativa rispetto al file relazione sulla gestione, ecc.
DataTrasmissioneTelematica data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
6.98InfoPdI2017È il data contract contenente le informazioni di PdI con codice 2017 (Dichiarazioni Unico persone fisiche).
PdI2017 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa Tipo di libro inventari.
134
Servizio CCTWeb Services – Specifiche Tecniche
6.99InfoPdI2018È il data contract contenente le informazioni di PdI con codice 2018 (Dichiarazioni Unico società di persone).
PdI2018 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
6.100 InfoPdI2019È il data contract contenente le informazioni di PdI con codice 2019 (Dichiarazioni Unico società di capitali).
PdI2019 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
135
Servizio CCTWeb Services – Specifiche Tecniche
6.101 InfoPdI2020È il data contract contenente le informazioni di PdI con codice 2020 (Dichiarazioni Unico enti non commerciali).
PdI2020 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
6.102 InfoPdI2021È il data contract contenente le informazioni di PdI con codice 2021 (Allegati dichiarazioni modello Unico).
PdI2021 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa
136
Servizio CCTWeb Services – Specifiche Tecniche
6.103 InfoPdI2022È il data contract contenente le informazioni di PdI con codice 2022 (Dichiarazioni IRAP).
PdI2022 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.104 InfoPdI2023È il data contract contenente le informazioni di PdI con codice 2023 (Dichiarazioni 730).
PdI2023 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
137
Servizio CCTWeb Services – Specifiche Tecniche
6.105 InfoPdI2024È il data contract contenente le informazioni di PdI con codice 2024 (Allegati dichiarazioni 730).
PdI2024 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa
6.106 InfoPdI2025È il data contract contenente le informazioni di PdI con codice 2025 (Dichiarazioni 730 precompilato).
PdI2025 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
138
Servizio CCTWeb Services – Specifiche Tecniche
6.107 InfoPdI2026È il data contract contenente le informazioni di PdI con codice 2026 (Allegati dichiarazioni 730 precompilato).
PdI2026 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
TipoAllegato stringa
6.108 InfoPdI2027È il data contract contenente le informazioni di PdI con codice 2027 (Dichiarazioni 730/4).
PdI2027 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
TipoComunicazione stringa
6.109 InfoPdI2028È il data contract contenente le informazioni di PdI con codice 2028 (Dichiarazioni consolidato nazionale e mondiale).
PdI2028 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
139
Servizio CCTWeb Services – Specifiche Tecniche
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.110 InfoPdI2029È il data contract contenente le informazioni di PdI con codice 2029 (Dichiarazioni IVA).
PdI2029 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.111 InfoPdI2030È il data contract contenente le informazioni di PdI con codice 2030 (Comunicazione annuale dati IVA).
PdI2030 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
140
Servizio CCTWeb Services – Specifiche Tecniche
6.112 InfoPdI2031È il data contract contenente le informazioni di PdI con codice 2031 (Prospetto delle liquidazioni periodiche dell'IVA).
PdI2031 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.113 InfoPdI2032È il data contract contenente le informazioni di PdI con codice 2032 (Dichiarazioni IVA 74 bis).
PdI2032 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.114 InfoPdI2033È il data contract contenente le informazioni di PdI con codice 2033 (Dichiarazioni IVA 26).
PdI2033 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
141
Servizio CCTWeb Services – Specifiche Tecniche
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
DataTrasmissione data-ora
TipoDichiarazione stringa
ProtocolloEntratelFisconline stringa
6.115 InfoPdI2034È il data contract contenente le informazioni di PdI con codice 2034 (Dichiarazioni 770 semplificato).
PdI2034 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
6.116 InfoPdI2035È il data contract contenente le informazioni di PdI con codice 2035 (Dichiarazioni 770 ordinario).
PdI2035 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
142
Servizio CCTWeb Services – Specifiche Tecniche
6.117 InfoPdI2036È il data contract contenente le informazioni PdI con codice 2036 (Certificaziona unica).
PdI2036 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa Soggetto a cui si riferisce a cui si riferisce la dichiarazione.
SostitutoImposta stringa
DataTrasmissione data-ora
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Tipo stringa
6.118 InfoPdI2037È il data contract contenente le informazioni di PdI con codice 2037 (Incarico per addebito telematico).
PdI2037 Tipo Descrizione
Anno intero Esercizio del file da conservare.
Contribuente stringa
DataIncaricoRevoca data-ora
Tipo stringa
6.119 InfoPdI2038È il data contract contenente le informazioni di PdI con codice 2038 (Impegno alla trasmissione telematica).
PdI2038 Tipo Descrizione
Anno intero Esercizio del file da conservare.
Contribuente stringa
DataImpegno data-ora
TipoImpegno stringa
143
Servizio CCTWeb Services – Specifiche Tecniche
6.120 InfoPdI2039È il data contract contenente le informazioni di PdI con codice 2039 (Ricevute AE presentazioni telematiche).
PdI2039 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
Contribuente stringa
DataRicevuta data-ora
TipoRicevuta stringa
6.121 InfoPdI2040È il data contract contenente le informazioni di PdI con codice 2040 (Studi di settore).
PdI2040 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Contribuente stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
6.122 InfoPdI2041È il data contract contenente le informazioni di PdI con codice 2041 (Istanze di rimborso IRAP).
PdI2041 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
DataInizio data-ora Data di inizio del periodo di competenza.
DataFine data-ora Data di fine del periodo di competenza.
Contribuente stringa
ModalitaTrasmissione stringa
DataTrasmissione data-ora
144
Servizio CCTWeb Services – Specifiche Tecniche
ProtocolloEntratelFisconline stringa
6.123 InfoPdI2042È il data contract contenente le informazioni di PdI con codice 2042 (Scheda destinazione 8 - 5 - 2 per mille).
PdI2042 Tipo Descrizione
Anno intero Esercizio del file da conservare.
Contribuente stringa
ModalitaTrasmissione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.124 InfoPdI2043È il data contract contenente le informazioni di PdI con codice 2043 (Domanda iscrizione 5 per mille).
PdI2043 Tipo Descrizione
Anno intero Esercizio del file da conservare.
Ente stringa
TipoComunicazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
145
Servizio CCTWeb Services – Specifiche Tecniche
6.125 InfoPdI2044È il data contract contenente le informazioni di PdI con codice 2044 (Dichiarazione di intento).
PdI2044 Tipo Descrizione
Anno intero Esercizio del file da conservare.
ProtocolloEntratelFisconline stringa
DataTrasmissione data-ora
Tipo stringa
6.126 InfoPdI2045È il data contract contenente le informazioni di PdI con codice 2045 (Modelli F24).
PdI2045 Tipo Descrizione
Anno intero Esercizio del file da conservare.
DataVersamento data-ora
Contribuente stringa
SezioniF24 stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
Tipo stringa
6.127 InfoPdI2046È il data contract contenente le informazioni di PdI con codice 2046 (Modelli F23).
PdI2046 Tipo Descrizione
Anno intero Esercizio del file da conservare.
DataVersamento data-ora
Contribuente stringa
CodiciTributo stringa
DataTrasmissione data-ora
146
Servizio CCTWeb Services – Specifiche Tecniche
ProtocolloEntratelFisconline stringa
Tipo stringa
6.128 InfoPdI2047È il data contract contenente le informazioni di PdI con codice 2047 (Comunicazione polivalente).
PdI2047 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
PeriodoRiferimentoMeseTrimestre stringa
DestinatarioComunicazione stringa
OrigineComunicazione stringa
Tipo stringa
TipologiaComunicazione stringa
FormatoComunicazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
6.129 InfoPdI2048È il data contract contenente le informazioni di PdI con codice 2048 (Intrastat).
PdI2048 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
PeriodoRiferimentoTrimestre stringa
PeriodoRiferimentoMese
SoggettoObbligato stringa
SoggettoDelegato stringa
TipoModello stringa
DataTrasmissione data-ora
ProtocolloServizioTelematicoDoganale stringa
147
Servizio CCTWeb Services – Specifiche Tecniche
6.130 InfoPdI2049È il data contract contenente le informazioni di PdI con codice 2049 (Dichiarazione dell'imposta di bollo (virtuale)).
PdI2049 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
PeriodoRiferimentoData data-ora
SoggettoDichiarazione stringa
TipoDichiarazione stringa
EstremiAutorizzazione stringa
AnnoRilascioAutorizzazione numero
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
6.131 InfoPdI2050È il data contract contenente le informazioni di PdI con codice 2050 (Comunicazione modelli AA5/AA6).
PdI2050 Tipo Descrizione
AnnoRichiesta intero Esercizio del file da conservare.
SoggettoImposta stringa
TipoRichiesta stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
148
Servizio CCTWeb Services – Specifiche Tecniche
6.132 InfoPdI2051È il data contract contenente le informazioni di PdI con codice 2051 (Comunicazione modelli AA7/AA9).
PdI2051 Tipo Descrizione
AnnoRichiesta intero Esercizio del file da conservare.
SoggettoImposta stringa
TipoDichiarazione stringa
DataTrasmissione data-ora
ProtocolloEntratelFisconline stringa
6.133 InfoPdI2052È il data contract deputato all’upload di PdI con codice 2052 (Dichiarazione sostitutiva unica (DSU)).
PdI2052 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
DataSottoscrizioneDSU data-ora
Dichiarante_CognomeNome stringa
Dichiarante_CodiceFiscale stringa
Tipo stringa
6.134 InfoPdI2053È il data contract contenente le informazioni di PdI con codice 2053 (Dichiarazione RED).
PdI2053 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
DataSottoscrizioneModelloRED data-ora
Pensionato_CognomeNome stringa
Pensionato_CodiceFiscale stringa
DataTrasmissione data-ora
149
Servizio CCTWeb Services – Specifiche Tecniche
Tipo stringa
6.135 InfoPdI2054È il data contract contenente le informazioni PdI con codice 2054 (Dichiarazione modelli INV.CIV).
PdI2054 Tipo Descrizione
PeriodoRiferimentoAnno intero Esercizio del file da conservare.
DataSottoscrizioneModello data-ora
Titolare _CognomeNome stringa
Titolare _CodiceFiscale stringa
DataTrasmissione data-ora
Tipo stringa
6.136 InfoPdI2055È il data contract contenente le informazioni PdI con codice 2057 (Log).
PdI2055 Tipo Descrizione
AnnoDelLog intero Esercizio del file da conservare.
DataEstrazione data-ora
TipoLog stringa
6.137 InfoPdI2056È il data contract contenente le informazioni PdI con codice 2056 (Pec).
PdI2056 Tipo Descrizione
AnnoMessaggio intero Esercizio del file da conservare.
CasellaMail_Pec stringa
DataMessaggio data-ora
OggettMessaggio stringa
IdMessaggio stringa
TipoMessaggio stringa
150
Servizio CCTWeb Services – Specifiche Tecniche
MittenteMessaggio stringa
DestinatarioMessaggio stringa
6.138 InfoPdI2057È il data contract contenente le informazioni PdI con codice 2057 (Mail).
PdI2057 Tipo Descrizione
AnnoMessaggio intero Esercizio del file da conservare.
CasellaMail_Pec stringa
DataMessaggio data-ora
OggettMessaggio stringa
IdMessaggio stringa
TipoMessaggio stringa
MittenteMessaggio stringa
DestinatarioMessaggio stringa
6.139 InfoPdI2058È il data contract contenente le informazioni PdI con codice 2058 (Lotto fatture emesse B2B).
PdI2058 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
DataEmissione data-ora
SoggettoDestinatario oggetto Soggetto a cui è destinato il documento: normalmente coincide con il SoggettoTitolare nel caso di documenti passivi o nel caso di documenti che non hanno una destinazione (Libri Giornali, Registri IVA, ecc.)
CodcieDestinatario stringa
Sezionale stringa
151
Servizio CCTWeb Services – Specifiche Tecniche
6.140 InfoPdI2059È il data contract contenente le informazioni PdI con codice 2059 (Lotto fatture ricevute B2B).
PdI2059 Tipo Descrizione
PeriodoImposta intero Esercizio del file da conservare.
DataRegistrazione data-ora
SoggettoFornitore oggetto Soggetto che ha originato il documento da conservare: normalmente coincide col SoggettoTitolare per i documenti attivi.
CodcieDestinatario stringa
Sezionale stringa
6.141 FileInfoFileInfo contiene i seguenti dati:
FileInfo: Tipo Descrizione
IdObject intero Identificativo univoco della pubblicazione che contiene il file.
IdDoc intero Identificativo univoco del file all’interno della pubblicazione.
FileType enumerato
Tipo del file (valori elencati nell’Appendice C).
FileName stringa Nome del file
FileDescr stringa Eventuale descrizione del file
FileSize intero Dimensione del file in byte
FileMD5 stringa Hashing MD5 del file
FileContent file Contenuto del file
152
Servizio CCTWeb Services – Specifiche Tecniche
6.142 SearchPdIData contract contenente l’espressione di ricerca dei PdI.
SearchPdI: Tipo Descrizione
SearchExpression oggetto Contenitore per le clausole di ricerca (Vedi Appendice B).
OrderBy oggetto Contenitore per le clausole di ordinamento (Vedi Appendice B).
PageSize intero Dimensione della pagina di dati richiesta
PageNumber intero Numero della pagina di dati richiesta
Per avere la massima flessibilità nelle ricerche sono previsti un oggetto di ricerca e uno di ordinamento generici (vedasi appendice B).
I filtri di ricerca che utilizzano SearchExpression e OrderBy specificano di volta in volta i campi (Field): questo approccio sacrifica la possibilità dell’utente di utilizzare l’intellisense per i parametri di ricerca ma riduce al minimo le modifiche necessarie ad introdurre nuovi campi. L’operazione controlla sempre che i campi specificati siano validi.
I campi di ricerca accettati dall’operazione RicercaPdI sono:
Nome campo Nome campo Nome campo
Produttore.Nome DataProtocollo SoggettoImposta
Produttore.Cognome DataRegistrazione SoggettoObbligato
Produttore.Denominazione DataRicevuta SostitutoImposta
Produttore.IdPaese DataSottoscrizioneDSU Tipo
Produttore.PartitaIVA DataSottoscrizioneModello TipoAllegato
Produttore.CodiceFiscale DataSottoscrizioneModelloRED TipoComunicazione
Titolare.Nome DataTrasmissione TipoImpegno
Titolare.Cognome DataTrasmissioneTelematica TipologiaComunicazione
Titolare.Denominazione DataUltimaRegistrazione TipoModello
Titolare.IdPaese DataVersamento TipoRicevuta
Titolare.PartitaIVA DenominazioneAmministrazione TipoRichiesta
Titolare.CodiceFiscale DenominazioneSoggetto DateChangeStatus
Destinazione.Nome DescrizioneDocumento DateCreation
153
Servizio CCTWeb Services – Specifiche Tecniche
Destinazione.Cognome Descrizione IdStatus
Destinazione.Denominazione DestinatarioComunicazione StatusName
Destinazione.IdPaese Dichiarante_CodiceFiscale FileName
Destinazione.PartitaIVA Dichiarante_CognomeNome HashValue
Destinazione.CodiceFiscale Ente IdPdI
Destinatario.Nome EsercizioFiscale IdTipoDocumento
Destinatario.Cognome EstremiAutorizzazione NumeroAnniConservazione
Destinatario.Denominazione FormatoComunicazione IdProvenienza
Destinatario.IdPaese ModalitaTrasmissione Provenienza
Destinatario.PartitaIVA ChiaveAssociazione DataOra1.Name
Destinatario.CodiceFiscale NomeFileOriginale DataOra1.Value
Fornitore.Nome NumeroBolla DataOra2.Name
Fornitore.Cognome NumeroDDT DataOra2.Value
Fornitore.Denominazione NumeroDocumentoFornitore DataOra3.Name
Fornitore.IdPaese NumeroFattura DataOra3.Value
Fornitore.PartitaIVA NumeroFatturaFornitore Decimale1.Name
Fornitore.CodiceFiscale NumeroFatturaOrigine Decimale1.Value
Origine.Nome NumeroDocumento Decimale2.Name
Origine.Cognome NumeroNota Decimale2.Value
Origine.Denominazione NumeroPrimaRegistrazione Decimale3.Name
Origine.IdPaese NumeroRegistrazioneIniziale Decimale3.Value
Origine.PartitaIVA NumeroProgressivoRegistro Intero1.Name
Origine.CodiceFiscale NumeroProtocolloInformatico Intero1.Value
Anno NumeroRegistrazione Intero2.Name
AnnoRegistro NumeroUltimaRegistrazione Intero2.Value
AnnoRichiesta NumeroRegistrazioneFinale Intero3.Name
AnnoRilascioAutorizzazione OrigineComunicazione Intero3.Value
CodiceAOO PaginaFinale Testo1.Name
CodiceIdentificativoRegistro PaginaIniziale Testo1.Value
CodiceIPA Pensionato_CodiceFiscale Testo2.Name
154
Servizio CCTWeb Services – Specifiche Tecniche
CodiceDestinatarioIPA Pensionato_CognomeNome Testo2.Value
CodiceAmministrazioneTitolare PeriodoImposta Testo3.Name
CodiceSdI Esercizio Testo3.Value
IdentificativoSdI PeriodoRiferimentoAnno
CodiciTributo PeriodoRiferimentoData
Contribuente PeriodoRiferimentoMese
DataCreazioneRegistro PeriodoRiferimentoMeseTrimestre
DataDocumento PeriodoRiferimentoTrimestre
DataEmissione ProtocolloEntratelFisconline
DataEmissioneFornitore ProtocolloServizioTelematicoDoganale
DataEmissioneOrigine NumeroProtocollo
DataFine ResponsabileRegistro
DataImpegno Sezionale
DataIncaricoRevoca SezioniF24
DataInizio SoggettoConservazione
DataPrimaRegistrazione SoggettoDelegato
DataProtocolloInformatico SoggettoDichiarazione
Per tutti i parametri di ricerca elencati è possibile specificare condizioni di ricerca in termini di valore del campo, campo compreso in intervalli specificati, ecc.
Sarà possibile formulare espressioni di ricerca arbitrarie ma limitate ai soli campi di ricerca ammessi utilizzando i seguenti operatori:
IsNull IsNotNull AND OR NOTLessThan LessEqual Equal NotEqual GreaterEqualGreaterThan StringLike StringStartWith StringEndWith StringContains
Per i dettagli logici sul funzionamento e le modalità di composizione della stringa di ricerca si rimanda all’appendice B.
Per i dettagli implementativi si rimanda invece al codice dei progetti di esempio.
155
Servizio CCTWeb Services – Specifiche Tecniche
6.143 SearchExpressionData contract contenente l’espressione di ricerca.
SearchExpression: Tipo Descrizione
SearchClause oggetto Contenitore della clausola di ricerca: viene utilizzata la notazione prefissa per la definizione di operatore ed operandi
6.144 SearchClauseData contract contenente la clausola dell’espressione di ricerca.
SearchClause: Tipo Descrizione
Operator enumerato Operatore dell’espressione di ricerca (Vedi Appendice C)
Arguments elenco Elenco degli argomenti dell’espressione di ricerca.Vedi tabella sotto per la definizione.
6.145 ArgumentData contract contenente un argomento (tipo e valore) di una clausola di ricerca.
Argument: Tipo Descrizione
ArgType enumerato
Tipo del valore dell’operando (Vedi Appendice C)
ArgValue oggetto Valore dell’operando
6.146 OrderByData contract contenente i parametri di ordinamento per l’espressione di ricerca dei PdI.
OrderBy: Tipo Descrizione
OrderByClauses elenco Elenco di contenitori di tipo OrderByClause contenenti le clausole di ordinamento
OrderByClause: Tipo Descrizione
FieldName stringa Nome del campo sul quale effettuare l’ordinamento
156
Servizio CCTWeb Services – Specifiche Tecniche
Direction enumerato
Tipo del valore di ordinamento (Vedi Appendice C)
È possibile ordinare per i seguenti campi:
Nome Descrizione
IdPdI Identificativo univoco della pubblicazione che contiene il messaggio restituito da SdI.
DateCreation È la data di creazione del PdI
IdStatus Identificativo dello stato corrente del PdI.
DateChangeStatus Data e ora in cui il PdI ha assunto lo stato corrente.
Si noti che non sono riportati i tipi dei campi accettati perché l’ordinamento è sempre formulato indicando se ascendente ASC o discendente DESC, è possibile specificare più campi di ordinamento nell’ordine desiderato con le stesse regole previste dall’SQL.
6.147 SearchPdIOutputData contract contenente il risultato di ricerca dei PdI:
SearchPdIOutput: Tipo Descrizione
ElencoInfoPdI elenco Elenco di oggetti InfoPdI.
PageNumber intero Numero della pagina di dati restituita.
PageSize intero Dimensione della pagina di dati restituita.
PageCount intero Numero di pagine totali recuperate dalla ricerca.
RecordCount intero Numero di record totali recuperati dalla ricerca.
157
Appendice C
Servizio CCTWeb Services – Specifiche Tecniche
7 Valori enumeratiTabelle dei parametri che assumono valori enumerati
Questa appendice elenca i parametri che assumono valori enumerati la cui codifica è stabilita dal Servizio CCT.
7.1 PdIFileTypeIl parametro PdIFileType (restituito all’interno di FileInfo e DatiDocumento) indica l’estensione del file contenuto nelle pubblicazioni:
FileType: Descrizione
pdf Estensione .pdf
pdf_p7m Estensione .pdf.p7m
pdf_m7m Estensione .pdf.m7m
tiff Estensione .tiff
tiff_p7m Estensione .tiff.p7m
tiff_m7m Estensione .tiff.m7m
jpg Estensione .jpg
jpg_p7m Estensione .jpg.p7m
jpg_m7m Estensione .jpg.m7m
xml Estensione .xml
xml_p7m Estensione .xml.p7m
xml_m7m Estensione .xml.m7m
txt Estensione .txt
txt_p7m Estensione .txt.p7m
txt_m7m Estensione .txt.m7m
eml Estensione .eml
eml_p7m Estensione .eml.p7m
158
Servizio CCTWeb Services – Specifiche Tecniche
eml_m7m Estensione .eml.m7m
tif Estensione .tif
tif_p7m Estensione .tif.p7m
tif_m7m Estensione .tif.m7m
jpeg Estensione .jpeg
jpeg_p7m Estensione .jpeg.p7m
jpeg_m7m Estensione .jpeg.m7m
xbrl Estensione .xbrl
xbrl_p7m Estensione .xbrl.p7m
xbrl_m7m Estensione .xbrl.m7m
ccf Estensione .ccf
ccf_p7m Estensione .ccf.p7m
ccf_m7m Estensione .ccf.m7m
fcf Estensione .fcf
fcf_p7m Estensione .fcf.p7m
fcf_m7m Estensione .fcf.m7m
rcc Estensione .rcc
rcc_p7m Estensione .rcc.p7m
rcc_m7m Estensione .rcc.m7m
7.2 HashTypeIl parametro HashType (contenuto all’interno di DatiDocumento) indica l’algoritmo di calcolo dell’hash di un array di byte
Tipo documento PdI: Descrizione
SHA-256 Algoritmo di crittografazione SHA-256
7.3 OperatorIl parametro Operator indica l’operatore da applicare all’espressione di ricerca:
159
Servizio CCTWeb Services – Specifiche Tecniche
Operator: Descrizione
IsNull Verifica che l’operando sia null
IsNotNull Verifica che l’operando non sia null
AND Concatena gli operatori specificati con un operatore AND
OR Concatena gli operatori specificati con un operatore OR
NOT Verifica che l’operando non rispetti la condizione specificata
LessThan Verifica che il primo operando abbia valore inferiore del secondo
LessEqual Verifica che il primo operando abbia valore inferiore od uguale del secondo
Equal Verifica che il primo operando abbia valore uguale del secondo
NotEqual Verifica che il primo operando abbia valore diverso dal secondo
GreaterEqual Verifica che il primo operando abbia valore maggiore od uguale del secondo
GreaterThan Verifica che il primo operando abbia valore maggiore del secondo
StringLike Verifica che il primo operando (di tipo stringa) abbia valore uguale del secondo
StringStartWith Verifica che il primo operando (di tipo stringa) abbia valore che coincide con l’inizio della stringa specificata come secondo operando
StringEndWith Verifica che il primo operando (di tipo stringa) abbia valore che coincide con la fine della stringa specificata come secondo operando
StringContains Verifica che il primo operando (di tipo stringa) abbia valore contenuto nella stringa specificata come secondo operando
7.4 ArgTypeIl parametro ArgType indica il tipo di dato utilizzato nell’espressione di ricerca e può valere:
ArgType: Descrizione
InnerSearchClause Il valore del parametro di ricerca è un ulteriore clausola di ricerca nidificata
FieldName Il valore del parametro è una stringa contenente il nome del campo sul quale effettuare la ricerca
IntValue Il valore del parametro è di tipo intero
160
Servizio CCTWeb Services – Specifiche Tecniche
StringValue Il valore del parametro è di tipo stringa
BooleanValue Il valore del parametro è di tipo booleano
DoubleValue Il valore del parametro è di tipo double
DateTimeValue Il valore del parametro è di tipo data
7.5 DirectionIl parametro Direction indica il tipo di ordinamento da effettuare sul campo specificato:
161
Direction: Descrizione
ASC Ordinamento crescente
DESC Ordinamento decrescente
Servizio CCTWeb Services – Specifiche Tecniche
8 Elenco erroriElenco completo degli errori restituiti dai Web Services
In questo capitolo vengono riepilogati tutti gli errori che possono essere restituiti dai Web Services del Servizio di Fatturazione Elettronica alla PA di TeamSystem.
In caso di errore il servizio invia al client una risposta del tipo:
<s:Envelope xmlns:s=http://www.w3.org/2003/05/soap-envelope xmlns:a="http://www.w3.org/2005/08/addressing"> <s:Header> <a:Action s:mustUnderstand="1">http://www.w3.org/2005/08/addressing/soap/fault</a:Action> <a:RelatesTo>urn:uuid:0d6ce642-c65e-4c5b-9933-2e5f7d23ccd3</a:RelatesTo> </s:Header> <s:Body> <s:Fault> <s:Code> <s:Value>s:Sender</s:Value>
<s:SubCode> <s:Value>s:1</s:Value> </s:SubCode>
</s:Code> <s:Reason> <s:Text xml:lang="it-IT">Id errore: [Guid dell’eccezione] - Parametro obbligatorio: UserName</s:Text> </s:Reason> </s:Fault> </s:Body></s:Envelope>dove il nodo <s:Code> contiene il FaultCode standard SOAP 1.2 Sender o Receiver a seconda che l’errore sia stato causato dai dati inviati dall’utente oppure da un errore del server ed il sottonodo <s:SubCode> contiene il codice di errore specifico; il nodo <s:Reason> invece contiene la
162
Appendice C
Servizio CCTWeb Services – Specifiche Tecniche
FaultReason, un messaggio composto dall’id univoco dell’eccezione (un guid) e la descrizione testuale dell’errore.
Nel caso in cui dal FaultCode e dalla descrizione della FaultReason non si capisca la causa dell’errore è possibile contattare il gestore del servizio facendo riferimento all’id dell’eccezione.
È possibile che in alcuni casi la risposta contenga anche ulteriori informazioni di dettaglio relative all’errore ma queste sono da considerarsi opzionali e non garantite per cui il client può limitarsi alla sola decodifica di FaultCode e FaultReason.
Gli errori sono suddivisi per categoria e la FaultReason indicata potrebbe essere oggetto di modifiche nel testo ma che non alterano il significato logico legato al FaultCode.
8.1 Errori nei dati della richiestaFaultCode FaultReason
401 Il parametro { nome parametro } è di tipo { tipo parametro } invece che { tipo parametro }
402 Il parametro { nome parametro } supera la lunghezza massima di { max valore } caratteri
403 Il parametro { nome parametro } deve avere lunghezza compresa tra { min valore }-{ max valore } caratteri
404 Il parametro { nome parametro } è obbligatorio
405 Il parametro { nome parametro } è obbligatorio e non può essere vuoto
406 Il parametro { nome parametro } è obbligatorio quando il parametro { altro parametro } è valorizzato
407 Il parametro { nome parametro } è obbligatorio quando il parametro { altro parametro } è valorizzato e vale { valore parametro }
408 Il parametro { nome parametro } è obbligatorio quando il parametro { altro parametro } è valorizzato e non vale { valore parametro }
409 Il parametro { nome parametro } è obbligatorio quando i parametri { altri parametri } non sono valorizzati
410 Il parametro { nome parametro } ha valore non compreso nel range { min valore }-{ max valore }
411 Il parametro { nome parametro } ha valore minore di { max valore }.
412 Il parametro { nome parametro } ha valore maggiore di { min valore }.
413 Il parametro { nome parametro } ha un valore di hash che non corrisponde a
163
Servizio CCTWeb Services – Specifiche Tecniche
quando settato nel parametro { altro parametro }
414 Il parametro { nome parametro } dichiara un'estensione file che non corrisponde al parametro { altro parametro }
415 Il parametro { nome parametro } ha una dimensione che non corrisponde a quanto settato nel parametro { altro parametro }
416 Il nome campo { nome parametro } non è tra quelli consentiti nell'espressione di ricerca
417 Il parametro { nome parametro } per la clausola con operatore {1} e argomenti {2} ha un numero di argomenti non valido in quanto {3}
418 Il parametro { nome parametro } per la clausola con operatore { nome operatore } ha un argomento che vale { valore parametro } ma è stato dichiarato di tipo { tipo parametro }
419 Il parametro { nome parametro } per la clausola con operatore { nome parametro } ha l'argomento di valore { valore parametro } di tipo { tipo parametro } che ammette solo una singola parola
420 Il parametro { nome parametro } non è tra quelli consentiti nell'espressione di ordinamento
421 Il parametro { nome parametro } per la clausola con ordinamento { tipo di ordinamento } ha il nome del campo che vale { valore parametro } ma che ammette solo una singola parola
422 Il parametro { nome parametro } è obbligatorio quando il parametro { altro parametro } vale { valore parametro }
423 Il parametro { nome parametro } deve essere nullo quando il parametro { altro parametro } vale { valore parametro }
424 Il parametro { nome parametro } contiene i valori { valori parametri } non validi quando il parametro { altro parametro } vale { valore altro parametro }
425 Il parametro { nome parametro } non contiene i valori { valori parametri } obbligatori quando il parametro { altro parametro } vale { valore altro parametro }
426 Il parametro FileName { valore parametro } non è valido per IdTipoDocumento { valore parametro }: deve essere nella forma { forma corretta nome file }
427 Il parametro ChiaveAssociazione { valore parametro } non è valido per IdTipoDocumento { valore parametro }: deve essere nella forma { valore parametro 2} e devono coincidere coi valori settati nel parametro FieldName { valore parametro 3}.
428 Il parametro { nome parametro } ammette valori { valori parametri } quando il parametro { altro parametro } vale { valore altri parametri }
164
Servizio CCTWeb Services – Specifiche Tecniche
429 Il parametro { nome parametro } ha valore non compreso tra i seguenti: { valori parametri }.
430 PdI non valido
8.2 Errori di sicurezzaFaultCode FaultReason
501 Accesso negatoErrore restituito quando la richiesta non presenta un SecurityToken valido.
502 Operazione non autorizzataErrore restituito quando l’utente, pur avendo fornito un SecurityToken valido non ha i permessi per eseguire l’operazione richiesta.
503 Username o password errati.
8.3 Errori in fase di elaborazioneFaultCode FaultReason
500 Errore inaspettato
504 Il parametro { nome parametro } non è valido
505 Il file con nome { nome file } ha dimesione pari a { valore parametro } bytes che supera la soglia massima di { max valore }
506 Tipo di hash non supportato: { valore parametro }
507 Tipo di file non supportato: { valore parametro }
508 File corrotto: { valore parametro }
509 Nessuna fattura o lotto associato alla notifica inviata: occorre prima inviare in conservazione la fattura/lotto
510 IdTipoDocumento { valore parametro } non valido
165