NoTIER Specifiche tecniche servizi - Intercent-ER

Transcript

NoTIER
Specifiche
tecniche servizi
Specifiche tecniche
servizi invio e recupero
documenti
NOTIER_AT_SpecificheServizi_v1.17.doc
Sommario
1 Premessa..........................................................................................................8
2 Note generali....................................................................................................8
2.1 Protocollo di comunicazione.......................................................................8
2.2 Sicurezza....................................................................................................8
2.3 Formato......................................................................................................8
2.4 Disponibilità................................................................................................8
3 Servizi REST......................................................................................................9
4 Servizio di invio documento.............................................................................9
4.1 Formato dei Documenti.............................................................................9
4.2 URL...........................................................................................................10
4.3 Richiesta...................................................................................................10
4.3.1 Formato dell'XML dei metadati di richiesta.........................................11
4.4 Risposta...................................................................................................16
4.4.1 URN.....................................................................................................16
4.4.1.1 Casi Particolari................................................................17
4.4.2 Formato del file XML di risposta.........................................................17
4.4.3 Codici di errore...................................................................................19
5 Servizio di recupero lista documenti..............................................................23
5.1 URL...........................................................................................................23
5.2 Richiesta...................................................................................................23
5.2.1 Formato dell'XML di risposta...............................................................25
5.2.2 Codici di errore...................................................................................28
6 Servizio di recupero documento.....................................................................29
6.1 URL...........................................................................................................29
6.2 Richiesta...................................................................................................29
6.3 Risposta....................................................................................................29
6.3.1 Formato dell'XML di risposta...............................................................30
6.3.2 Codici di errore...................................................................................30
7 Integrazione Dati Fiscali.................................................................................31
NotiER – Specifiche tecniche servizi
2/78
7.1 URL...........................................................................................................31
7.2 Richiesta...................................................................................................31
7.2.1 Formato XML dei Metadati di Richiesta..............................................32
7.3 Risposta....................................................................................................36
7.3.1 Formato del file XML di risposta.........................................................36
7.3.2 Codici di errore...................................................................................36
8 Conservazione Ordini e DDT...........................................................................37
Appendice A – Esempi di Invocazione dei Servizi noTIER.................................39
A.1 Invio Documento di tipo Fattura SDI con Esito Positivo..............................39
A.1.1 Esempio di request HTTP con invio dei file di metadati e del
documento...................................................................................................39
A.1.2 File XML “metadati” ..........................................................................42
B.1.3 File XML “documento” ......................................................................44
B.1.4 File XML di Esito Risposta..................................................................44
A.2 Invio Documento di tipo Fattura PEPPOL con Esito Negativo.....................46
A.2.1 File xml “metadati” ..........................................................................46
A.2.2 File xml “documento”........................................................................49
A.2.3 File xml di Esito Risposta...................................................................50
A.3 Invio Documento di tipo Documento di Trasporto a PEPPOL con esito
Positivo..............................................................................................................51
A.3.1 File xml “metadati” ..........................................................................52
A.2.2 File xml “documento”........................................................................54
A.4 Recupero Notifiche di Esito in Stato “Da recapitare” per un destinatario
specificato.........................................................................................................57
A.4.1 Query String di Invocazione del Servizio...........................................57
A.5 Recupero Documento con Esito Negativo..................................................60
A.6 Recupero di Notifica MDN..........................................................................62
3/78
A.6.2 File xml di Esito Positivo ...................................................................62
A.6.3 File xml di Esito Negativo..................................................................64
A.7 Integrazione Dati Fiscali con esito positivo................................................66
A.7.1 File XML “metadati” ..........................................................................66
A.7 Recupero di Esito Versamento con Esito Positivo......................................68
A.7.2 File XML di Esito Risposta..................................................................68
A.8 Metadati PEPPOL........................................................................................79
4/78
Cliente:
IntercentER
Progetto/Servizio:
Centro di Interscambio NoTIER
Codice Commessa/e:
Data:
Redatto da:
Larosa Giuseppe, Quaranta Marco
Approvato da:
Consegnato a:
Versione:
1.15
Nome documento:
Versione
Data
Autore
Marco Quaranta
Cambiamenti apportati
1.0
28/03/2014
1.1
18/04/2014
Marco Quaranta
Prima stesura
1.2
28/04/2014
Marco Quaranta
Revisione
Post-Incontro
IntercentER e CUP 2000
1.3
05/05/2014
Marco Quaranta
Aggiunta gestione del documento
SDI “Notifica Metadati del file fattura
al destinatario”
1.4
06/05/2014
Giuseppe Larosa
Aggiunta tabella di associazione con
Schema XSD di servizio e Paragrafo
4.1
1.5
15/05/2015
Giuseppe Larosa
Servizi di Integrazione Dati Fiscali
1.6
22/05/2014
Giuseppe Larosa
Giuseppe Larosa
Draft
Modifiche
in
seguito
a
con
riunione
IntercenteER del 21/05/2014
Aggiunto all’URN del documento n
1.7
09/06/2014
Marco Quaranta
un
attributo
che
indica
se
il
documento fa parte del ciclo attivo o
passivo
1.8
18/06/2014
Marco Quaranta
Corretti URL dei servizi
Modificato xsd WS integrazione dati
conservazione:
AnnoProtocollo
campo
diventa
Data
Protocollo
Modificati
i
recupero
lista
filtri
del
servizio
diventa
statoConservazione
documenti:
di
stato
5/78
e
statoGiacenza
Inserita versione dei documenti UBL,
paragrafo 4.1
L’urn generato da Notier ha come
1.9
08/07/2014
Giuseppe Larosa
separatore i due punti “:”
Corrette le URL dei servizi
Rimossi in appendice gli XSD dei
servizi
Precisazione relativa alla necessità di
specificare l’attributo filename nel
1.10
08/08/2014
Marco Quaranta
content-disposition
nel
servizio
di
del
documento
invio
documento.
Allineato l’esempio in Appendice
1.11
28/08/2014
Rimossa nota numero 19
Corretto
attributo
nell’header
1.12
03/09/2014
filename
content-disposition
Marco Quaranta
nell’esempio in appendice. Corretto
Giuseppe Larosa
Refuso su Host in esempio.
Gestione Registro in invio documento
nel caso di Fatture e Note di credito
1.13
Larosa Giuseppe
Correzione Refusi
Correzione Refusi – Versione SDI 1.1
Aggiunta Nota su URN della Notifica
di Esito Committente
1.14
11/02/2015
Larosa Giuseppe
Ordinamento
recupero
lista
documenti in data decrescente.
Indice offset parte da 0
Impossibile scaricare i collegati un
doc in lavorazione.
Adeguamento del Documento alla
gestione Ordini e DDT (NoTIER Fase
2)
Inserita Appendice A.5 con Metadati
1.15
06/10/2015
Larosa Giuseppe
PEPPOL , A.3 con esempio DDT e A.6
con Notifica MDN, A.7 con Esito di
Versamento.
Casi notevoli nella generazione URN.
Aggiunta tag Collegato a Metadati di
Invio
1.16
02/03/2015
Arduini Iacopo
Adeguamento degli urn di Ordini e
DDT alle specifiche Peppol
Rimosso
codice
di
errore
6/78
ERR_INVIODOC_004 in quanto non
corretto
Aggiunta nota nel paragrafo 6 per
sconsigliare
tentativi
di
calcolo
dell’URN di un documento
Modifica notifica MDN (versione 1.1)
con descrizione errore in caso di
1.17
07/09/2016
Stefano Sinatti
esito
Modifica
KO.
servizio
di
InvioDatiIntegrazione (versione 1.1).
Schema XSD associati:
Nome
Versione
InvioDocumento.xsd
1.0
EsitoRichiesta.xsd
1.0
InvioDatiIntegrazione.xsd
1.1
NotificaMDN.xsd
1.1
WSResponseVersamento.xsd (Esito Versamento in ParER)
1.4
7/78
1 Premessa
Il presente documento ha lo scopo di descrivere le specifiche tecniche dei
servizi esposti dal Centro di Interscambio.
Essi sono:
-
Servizio di invio Documento.
-
Servizio di recupero Lista Documenti.
-
Servizio di recupero Documento.
-
Servizio di Integrazione dei Dati Fiscali per invio del Documento in
Conservazione (PARER).
2 Note generali
2.1 Protocollo di comunicazione
I servizi offerti utilizzano il protocollo HTTP ed espongono delle API REST. In
particolare i metodi HTTP previsti sono GET e POST.
2.2 Sicurezza
Tutte le comunicazioni avvengono su protocollo HTTPS.
L’autenticazione e successiva autorizzazione dei client avviene tramite
certificato X.509 inviato dai client stessi al momento della chiamata.
2.3 Formato
Le API REST prevedono un dialogo basato su linguaggio XML.
Tutti i documenti e i metadati che vengono scambiati tra i client e NoTIER
hanno content-type “application/xml” e charset “utf-8”.
2.4 Disponibilità
In caso di non disponibilità del servizio, l'applicativo chiamante potrebbe:
8/78

Non ottenere alcuna risposta. In tal caso, se previsto dal client, nella
logica applicativa chiamante potrebbe attivarsi un timeout.

Ottenere una risposta con codice HTTP 503.
3 Servizi REST
L’URL di base di tutti i Servizi REST esposti è
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/
4 Servizio di invio documento
Il servizio di invio documento consente al client di inoltrare un documento a
NoTIER. L’applicativo chiamante invoca il servizio inviando tramite una POST
HTTP due file:

Un file XML contenente i metadati necessari perché il documento venga
acquisito ed elaborato correttamente.

Un file contenente il documento oggetto dell'invio.
4.1 Formato dei Documenti
Dato che NoTIER svolge funzioni di intermediario avanzato verso SDI, PEPPOLBusDox e il sistema di Conservazione (PARER), i documenti inviabili tramite il
Servizio di Invio devono essere in uno dei relativi formati XML previsti. A tali
formati corrispondono degli specifici Schemi XSD ed è a cura del client
comporre Documenti XML in grado di superare la validazione
effettuata da NoTIER contestualmente all’invio. In particolare:

Per quanto riguarda agli schema XSD relativi ai documenti SDI (Fattura e
Notifica di Esito Committente) fare riferimento alla documentazione sul
sito http://www.fatturapa.gov.it/

Per quanto riguarda gli schema XSD relativi ai documenti PEPPOL, fare
riferimento alla documentazione PEPPOL dei relativi Profili UBL.
9/78

Per quanto riguarda gli schemi XSD relativi alle notifiche di Esito
Conservazione in PARER fare riferimento alla documentazione disponibile
sul
sito
http://parer.ibc.regione.emilia-romagna.it/servizi/modalitatecniche-per-avviare-i-servizi-di-conservazione 1
I Formati associabili ai Documenti sono i seguenti:
Tipo Documento
Formato
Versione
UBL
2.1
SDI2
1.1
Notifica di Esito
Committente
SDI
1.0
Nota di credito
UBL
2.1
Ordine
UBL
2.1
Documento di Trasporto
UBL3
2.1
Fattura
4.2 URL
La URL per invocare il servizio di Invio Documento è la seguente
POST https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/invio
4.3 Richiesta
La request deve essere una POST HTTP all’indirizzo specificato nel Paragrafo
4.2 e deve:
1
Relativamente a PARER è tuttora previsto solamente che il client sia in grado di
acquisireil formato XML dell’esito di Invio in Conservazione.
2
Nel caso di fattura in formato SDI, essa deve pervenire a NoTIER già firmata come
previsto dalle specifiche di Servizio SDI. Questo formato è supportato solamente ai fini del
versamento in ParER e non è ammesso per l’invio a SDI.
3
Il Documento di Trasporto o l’ordine possono pervenire a NoTIER firmati digitalmente, ma è
ammesso il solo formato di firma XAdES.
10/78

Specificare un Request Header Content-Type di tipo “multipart/formdata”

Specificare un Payload composto da due parti, ciascuna identificata da un
Payload Header Content-Disposition “form-data” come segue:
o Attributo name= “metadati” per l’XML con i Metadati
o Attributo name=“documento” per l’XML del Documento
o Attributo filename valorizzato4

Come descritto nel Paragrafo 2.3, ciascuna parte del Payload dovrà
inoltre avere un Payload Header Content-Type: application/xml;
charset=UTF-8
Per un esempio di Request fare riferimento al Paragrafo A.1.1 Esempio di
request HTTP con invio dei file di metadati e del documento.
44444
Formato dell'XML dei metadati di richiesta
I metadati da inviare nella richiesta sono descritti dall'XSD “InvioDocumento”
versione 1.0
Segue la descrizione dei campi dichiarati all'interno dello schema.
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio Obblig
atorio
Inizio Sezione <InvioDocumento> [1..1]
Versione
Versione dell'XML del
servizio di invio documento
10 caratteri max
Stringa
1.0
SI
Inizio sezione <InvioDocumento>/<Documento> [1..1]
Inizio sezione <InvioDocumento>/<Documento>/<Chiave> [1..1]
Mittente
TipoMittente
4
Codice identificativo
del mittente del
documento
Definisce la tipologia di
codice presente nel
campo “Mittente”
Stringa
ORG-ENTE1
SI
Tipo
predefinito
NOTIER
SI
50 caratteri max
Valori ammessi:
NOTIER
Il nome del file può essere qualunque
11/78
Tag XML
Descrizione
Anno
Vincoli
Anno del documento
4 caratteri
FATTURA/NDC
Tipo
dato
Numerico
2014
SI
Stringa
Esempio 1:
SI
Numero del documento
che deve essere univoco e
riportare:
300-2014000001
- Registro Fattura
- Anno (nel caso in cui il
numero progressivo
venga azzerato
all’inizio di ogni anno,
diversamente non è
necessario)
Numero5
Esempio Obblig
atorio
Esempio 2:
300000000000
1
50 caratteri max
- Numero Progressivo
ORDINE/DDT
che identifica
univocamente l’ordine /
documento di trasporto
Tipologia di documento
Valori ammessi:
- FATTURA
Tipo
predefinito
FATTURA
SI
- NOTA_DI_CREDITO
- ORDINE
TipoDocumento
DOCUMENTO_DI_TRASPOR
TO
- NOTIFICA
_DI_ESITO_COMMITTENTE
Fine sezione <InvioDocumento>/<Documento>/<Chiave>
Inizio sezione <InvioDocumento>/<Documento>/<Rappresentazione> [1..1]
Formato del documento
Formato
Valori ammessi:
- UBL
Tipo
predefinito
UBL
SI
Stringa
1.0
SI
- SDI
Versione
Versione del formato del
documento
10 caratteri max
Fine sezione <InvioDocumento>/<Documento>/<Rappresentazione>
5
Il valore nel campo deve coincidere con il cbc: ID (Document Identifier) riportato nella Testata del Documento XML. Tale valore è
oggetto di controllo anche in fase di versamento in conservazione.
12/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio Obblig
atorio
Fine sezione <InvioDocumento>/<Documento>
Inizio sezione <InvioDocumento>/<Configurazione> [1..1]
Indica se il documento è
da inoltrare a SDI
Se posto a true allora il
tag InvioPeppol deve
valere false
Booleano
true
SI
Se posto a true allora il
tag InvioSdi deve valere
false
Booleano
false
SI
InvioPeppol
da inoltrare ad un altro
Access Point su rete
Busdox-Peppol
da archiviare in
conservazione
Se InvioSdi e InvioPeppol
sono entrambi a false
allora deve valere true
Booleano
true
SI
InvioConservazione
Indica se il documento,
una volta trasformato e
ApprovazioneAutomatic
firmato, è da considerarsi
aErrore: sorgente del
automaticamente
riferimento non trovata
approvato e quindi
idoneo all'invio verso SDI
Booleano
true
SI
Se posto a true consente
al trasmittente di inviare
un documento avente la
medesima chiave di un
documento già presente
nel sistema
Booleano
true
SI
_Aa.99-2
SI se Tipo
Documen
to
FATTURA
o NOTA
InvioSdi6
AccettaChiaveDuplicat
a7
Fine sezione <InvioDocumento>/<Configurazione>
Inizio sezione <InvioDocumento>/<Integrazione> 8 [0..1]
Registro
Identificativo del Registro o
del Tipo di Registro della
Fattura o della Nota di
Credito.
100 caratteri max9
Stringa
6
Il valore di questo flag è significativo solo nel caso in cui il Documento inviato sia una Fattura
o Nota di Credito
7
Il flag deve essere abilitato se si vuole inviare un generico Documento che ne duplichi uno
precedentemente già inviato. Ad esempio nel caso di una Fattura, qualora quest’ultima abbia
ricevuto una Notifica di Scarto o di Esito Cedente con esito negativo. In ogni caso NoTIER non
sovrascrive il precedente Documento, bensì procede ad effettuare un versionamento
dello stesso. Il flag si deve usare anche per la riemissione di un ordine o di un
documento di trasporto.
8
L’Elemento è obbligatorio se il tipo di documento inviato è una Fattura oppure una Nota
di Credito .
9
La stringa deve iniziare con un numero, un carattere oppure “_” e non può contenere
caratteri speciali con l’esclusione di “_”, “-”, “.”
13/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio Obblig
atorio
DI
CREDITO
Fine sezione <InvioDocumento>/< Integrazione >
Inizio sezione <InvioDocumento>/<Collegamento10> [0..1]
Urn
Urn NoTIER del Documento
da Collegare
256 caratteri max
Stringa
Si
Inizio sezione <InvioDocumento>/<Collegamento> [0..1]
Inizio sezione <InvioDocumento>/<MetadatiBusdox11> [0..1]
Identificativo busdox del
destinatario del documento
RecipientIdentifier
mittente del documento
SenderIdentifier
DocumentIdentifier
tipo di documento
ProcessIdentifier
processo in cui il
documento è utilizzato
256 caratteri max
256 caratteri max
1024 caratteri max
1024 caratteri max
Stringa
Stringa
Stringa
Stringa
12
SI se la
sezione
Metadati
Busdox è
presente
13
SI se la
sezione
Metadati
Busdox è
presente
14
SI se la
sezione
Metadati
Busdox è
presente
Errore:
SI se la
sorgente
sezione
del
Metadati
riferimento Busdox è
non trovata presente
Fine sezione <InvioDocumento>/<MetadatiBusdox>
Fine sezione <InvioDocumento>
10
E’ possibile specificare un collegamento tra Documenti Principali, es. ad una Fattura può
essere collegato il relativo Ordine inviato precedentemente in NoTIER, specificandone l’URN.
Tale collegamento viene reso esplicito nell’interfaccia di Monitoraggio WEB di NoTIER.
11
L’Elemento e’ obbligatorio se tag “InvioPeppol” = true
12
Nel Formato previsto dalle Specifiche PEPPOL Ad Es.: 9921: IT 78K5FY
13
Nel Formato previsto dalle Specifiche PEPPOL Ad Es.: :9906:IT 02249070356
14
Si veda l’ Appendice A7
14/78
4.4 Risposta
NoTIER fornisce in risposta l’esito dell’operazione di invio in formato XML. Essa
riporta, in caso di esito positivo, la chiave univoca e l'URN assegnato al
Documento, in caso di esito negativo il codice d'errore e la relativa descrizione.
44444 URN
L'URN è una stringa che identifica univocamente il documento ed è calcolato
da NoTIER concatenando nel seguente modo i metadati forniti dal chiamante in
fase di richiesta:
urn:notier:<MittenteNotier>:<Anno>:<Numero>:<TipoCiclo>:<TipoDo
cumento>
L’attributo TipoCiclo può assumere valori
-
CA per il Ciclo Attivo
-
CP per il Ciclo Passivo
 Casi Particolari
Eventuali caratteri speciali presenti nel Numero che compone l’URN sono
sostituiti con una stringa di caratteri derivata dalla relativa Codifica Unicode,
Es: il carattere “/” viene sostituito con la stringa “_U002F_”.
Nel caso di Notifica Esito Committente, il Numero in URN è concatenato al
ID noTIER del Ufficio Emittente della Fattura a cui la Notifica è correlata.
Nel caso di Ordine e Documento di Trasporto, l’URN prevede un campo che
identifica la Versione del Documento, come segue:
urn:notier:<MittenteNotier>:<Anno>:<Numero>:<TipoCiclo>:<TipoDocumen
to>:<NumeroVersione>
La versione “01” corrisponde al primo invio del Documento e si
incrementa ad ogni successivo invio 15, consentendo così di reinviare un Ordine
o un DDT con gli stessi metadati. 16
15
Analogamente a Fattura e NdC, NoTIER prevede il versionamento di Ordine e DDT, che
quindi non sovrascrivono i precedenti inviati con gli stessi metadati.
16
NoTIER esegue comunque una verifica Hash MD5 sul file inviato per impedire che un
Documento con lo stesso contenuto venga inviato più volte.
15/78
Nel caso di documenti del Ciclo Passivo di tipo Ordine o DDT, il versionamento
è attivato automaticamente da NoTIER al ricevimento di un documento con la
stessa chiave logica e contenuto diverso.
44444 Formato del file XML di risposta
L'XML di risposta prodotto è descritto dall’XSD “EsitoRisposta” versione 1.0.
Segue una descrizione dei campi dichiarati all'interno dello schema.
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio
Obbli
gatori
o
1.0
SI
Inizio Sezione <EsitoRichiesta> [1..1]
Versione
Versione dell'XML di esito
risposta
10 caratteri max
Stringa
Inizio sezione <EsitoRichiesta>/<Esito> [1..1]
CodiceEsito
CodiceErrore
DescrizioneErrore
Esito della richiesta. Vale
OK in caso di esito positivo,
WARN se il documento era
già stato inviato ma il tag
AccettaChiaveDuplicata in
fase di chiamata è posto a
true, KO in caso di esito
negativo
Valori ammessi:
Tipo
predefinito
SI
Definisce il codice
dell'errore 17
Presente se
CodiceEsito=KO
Tipo
predefinito
NO
Descrizione dell'errore
Presente se
CodiceEsito=KO
Stringa
NO
- OK
- WARN
- KO
Fine sezione <EsitoRichiesta>/<Esito>
Inizio sezione <EsitoRichiesta>/<Documento> [1..1]
Urn
Identificatore del
documento in NoTIER
DataRicezioneNotier
1024 caratteri max
Data e ora assegnata da
NoTIER al momento del
ricevimento del
documento
Stringa
urn:notier
:IORG001:2015
:2_85:CA:
FATTURA
Data
SI
SI
Inizio sezione <EsitoRichiesta>/<Documento>/<Chiave> [1..1]
Mittente
17
Codice identificativo
50 caratteri max
Stringa
ORG-001
SI
Per il significato e la descrizione dei codici d'errore si veda il Paragrafo 4.4.3
16/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio
Obbli
gatori
o
del mittente del
documento
TipoMittente
Definisce la tipologia
di codice presente nel
Valori ammessi:
Anno del documento
4 caratteri
Numero
Numero del
documento
TipoDocumento
Tipologia di
documento
Anno
Tipo
predefini
to
NOTIER
SI
Numerico
2014
SI
50 caratteri max
Stringa
1/8
SI
Valori ammessi:
Tipo
predefini
to
FATTURA
SI
- FATTURA
- NOTA_DI_CREDITO
- ORDINE
- DOCUMENTO_DI_TRASPORTO
- NOTIFICA
_DI_ESITO_COMMITTENTE
Fine sezione <EsitoRichiesta>/<Documento>/<Chiave>
Inizio sezione <EsitoRichiesta>/<Documento>/<Rappresentazione> [1..1]
Formato
Valori ammessi:
- UBL
Tipo
predefinito
UBL
SI
Stringa
1.0
SI
- SDI
Versione
Versione del formato del
documento
10 caratteri max
Fine sezione <EsitoRichiesta>/<Documento>/<Rappresentazione>
Fine sezione <EsitoRichiesta>/<Documento>
Fine sezione <EsitoRichiesta>
44444 Codici di errore
In caso di risposta con esito negativo (tag CodiceEsito = KO) NoTIER valorizza il
tag CodiceErrore con uno dei valori definiti nell'XSD EsitoRichiesta e di cui
segue la descrizione.
Codice
ERR-000-GENERICO
Descrizione
Codice d'errore generico. Indica che NoTIER non è riuscito ad
elaborare la richiesta a causa di un errore generico interno.
17/78
Codice
Descrizione
Rientrano in questa categoria gli errori causati ad esempio dalla
non disponibilità del database o problemi di natura sistemistica. Il
client deve considerare la richiesta come non processata e
provvedere a re inoltrarla.
Ulteriori dettagli dell’ errore saranno comunque riportati nel tag
<EsitoRichiesta>/<Esito><DescrizioneErrore>
ERR-000-INVIODOCRICHIESTA-NON-VALIDA
Indica che la richiesta non è valida. La causa dell’ errore verrà
dettagliata
nel
tag
e
dipende
generalmente dalla mancanza del file di Metadati e/o del
Documento all’atto dell’ invio.
ERR-001-INVIODOC-XMLNON-VALIDO
Indica che l'XML dei metadati non è valido.
L'errore si ottiene al verificarsi di in una delle seguenti condizioni:

l'XML non è valido rispetto l'XSD di InvioDocumento nella
versione specificata

l'XML
definisce
il
valore
<InvioDocumento>/<Versione> diverso
versione dichiarata nell'URL di chiamata

l'XML definisce entrambi i tag
<InvioDocumento>/<Configurazione>/<InvioSdi> e
<InvioDocumento>/<Configurazione>/<InvioPeppol>
valorizzati a true

l'XML definisce i tag
<InvioDocumento>/<Configurazione>/<InvioSdi>,
e
<InvioDocumento>/<Configurazione>/<InvioConserv
azione> tutti valorizzati a false

l’XML valorizza i tag
a true, ma non è presente il tag
<InvioDocumento>/<MetadatiPeppol> necessario per il
corretto instradamento del documento su rete BusDox

Il tipo di Documento specificato è una Fattura o una Nota
di Credito, ma non è presente il tag contenente
l’informazione del registro:
<InvioDocumento>/<Integrazione> necessario per
effettuare correttamente l’ integrazione ai fini di
conservazione in Parer

Il tipo di Documento dichiarato all’interno del tag
<InvioDocumento>/<Documento>/<Chiave>/<TipoDo
del
rispetto
tag
alla
18/78
Codice
Descrizione
cumento>, non è presente nel sistema
ERR-INVIODOC-002-NONAUTORIZZATO
Indica che il chiamante, identificato tramite il Common Name del
certificato X.509 non è autorizzato a richiamare il servizio oppure
non è autorizzato all'invio del documento della tipologia specificata
nel
tag
<InvioDocumento>/<Documento>/<Chiave>/<TipoDocumen
to>
ERR-INVIODOC-003-ORGNON-VALIDA
Indica che l'organizzazione, dichiarata all'interno dei tag
<InvioDocumento>/<Documento>/<Chiave>/<Mittente> e
<InvioDocumento>/<Documento>/<Chiave>/<TipoMittente
>, non è presente nel sistema
ERR-INVIODOC-005FORMATO-RAPPR-NONVALIDO
Indica che il formato di rappresentazione, dichiarato all'interno del
tag
<InvioDocumento>/<Documento>/<Rappresentazione>/<F
ormato>, non è presente nel sistema
ERR-INVIODOC-006VERSIONE-RAPPR-NONVALIDA
Indica che la versione di rappresentazione, dichiarata all'interno
del tag
<InvioDocumento>/<Documento>/<Rappresentazione>/<V
ersione>, non è presente nel sistema
ERR-INVIODOC-007-DOCNON-VALIDO-XSD
Indica che il documento inviato non è valido rispetto l'XSD a cui è
associato
ERR-INVIODOC-008-DOCNON-VALIDOSCHEMATRON
Indica che il documento inviato non è valido rispetto lo Schematron
a cui è associato
ERR-INVIODOC-009-DOCDUPLICATO
Indica che il documento inviato è già stato ricevuto in un'altra
chiamata da NoTIER. Questo errore si verifica quando fallisce in
sequenza uno dei seguenti controlli, in ordine:

Il file xml relativo al Documento è già stato inviato in
precedenza a NoTIER.18

Il valore del flag AccettaChiaveDuplicata è impostato a
false.
Il Documento non è in uno stato compatibile con la sovrascrittura 19

18
Ad ogni invio NoTIER esegue una verifica sull’ Hash MD5 del file xml del Documento,
confrontandola con quelle dei Documenti già ricevuti in precedenza.
19
Solo relativamente a Fattura e Nota di Credito, che sono associate ad uno Stato di
Esito.
19/78
5 Servizio di recupero lista documenti
Il servizio di recupero lista Documenti consente al chiamante di ottenere la lista
dei Documenti di propria competenza, ossia di cui è destinatario.
5.1 URL
GET
https://<host-NoTIER>:<portaNoTIER>/notier/rest/v1.0/documenti/recupero/
5.2 Richiesta
La request deve essere una GET HTTP verso l'indirizzo specificato nel
Paragrafo 5.1
Il servizio di recupero consente di effettuare il recupero anche previa specifica
di alcuni parametri di filtro. In tabella se ne riporta la descrizione.
Filtro
idnotier
Descrizione
Codice identificativo NoTIER del destinatario dei documenti
Obbl
NO
Esempio:
/notier/rest/v1.0/documenti/recupero/?idnotier=org-002
tipodoc
Restituisce la lista di tutti i documenti destinati al
NO
chiamante aventi la tipologia specificata
Esempio:
/notier/rest/v1.0/documenti/recupero/?tipodoc=fattura
stato_giacenza
NO
chiamante con lo stato giacenza specificato
Esempio: /notier/rest/v1.0/documenti/recupero/?
stato_giacenza=da_recapitare
stato_conservazio
ne
NO
chiamante con lo stato di conservazione specificato
Esempio: /notier/rest/v1.0/documenti/recupero/?
stato_conservazione=da_recapitare
20/78
Filtro
data_inizio
Descrizione
Obbl
Parametro utilizzato per abilitare il filtraggio per data di
NO
ricezione Notier della lista di documenti, indica la data di
inizio.
La data va specificata nel formato GGMMAAAA
Esempio: /notier/rest/v1.0/documenti/recupero/?data_inizio=01012014
data_fine
Parametro utilizzato per abilitare il filtraggio per data di
NO
ricezione Notier della lista di documenti, indica la data di
inizio
La data va specificata nel formato GGMMAAAA
Esempio: /notier/rest/v1.0/documenti/recupero//?data_fine=01012014
inizio
Parametro utilizzato per abilitare la paginazione della lista
SI
21
di doumenti, indica l’indice da cui iniziare la paginazione. 20
Esempio: /notier/rest/v1.0/documenti/recupero/?inizio=1&offset=100
offset
Parametro utilizzato per abilitare la paginazione della lista
SI22
di documenti, indica il numero di documenti da restituire a
partire dal valore del parametro “inizio”.
Esempio: /notier/rest/v1.0/documenti/recupero/??inizio=1&offset=100
La richiesta con parametri, come mostrato in tabella nella colonna descrizione,
va effettuata invocando l’url specificata nel Paragrafo 5.1 a cui aggiungere i
parametri nella forma chiave=valore, preceduti da punto interrogativo (?) e
separati da carattere ampercent (&).
Il servizio restituisce un massimo di 500 documenti. NoTIER fornisce in risposta
la eventuale lista dei Documenti di competenza del chiamate estratta in base
ai parametri di filtro forniti in ingresso. La lista viene restituita ordinata
per Data di Ricezione in NoTIER in ordine decrescente. 23
20
Per convenzione l’indice del primo documento è 0
21
Solo se è stato specificato il parametro offset
22
Solo se è stato specificato il parametro inizio
21/78
44444 Formato dell'XML di risposta
L'XML di risposta prodotto è descritto dall’XSD “EsitoRisposta” versione 1.0.
Segue una descrizione dei campi dichiarati all'interno dello schema.
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempi Obbligator
o
io
Versione
Versione dell'XML di
esito risposta
10 caratteri max
Stringa
1.0
SI
CodiceEsito
CodiceErrore
Esito della richiesta.
Vale OK in caso di esito
positivo, KO in caso di
esito negativo
Valori ammessi:
Definisce il codice
dell'errore24
DescrizioneErrore Descrizione dell'errore
Tipo
predefinito
SI
Presente se CodiceEsito=KO
Tipo
predefinito
NO
Presente se CodiceEsito=KO
Stringa
NO
- OK
- KO
Inizio sezione <EsitoRichiesta>/<ListaDocumenti> [1..1]
NumeroDocument Numero di documenti
i
presenti nella lista.
Determina il numero di
tag
<EsitoRichiesta>/<Lis
taDocumenti>/<Docu
menti>/<Documento
> presenti nella risposta
Numero
5
SI
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti> 25 [0..1]
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento> 26 [1..N]
Destinatario
Codice NoTIER
identificativo del
50 caratteri max
Stringa
ORG-001
SI
23
L’ordinamento per data Ricezione si applica anche in caso vengano applicati i filtri previsti
dal Servizio.
24
25
La sezione non è presente quando il tag NumeroDocumenti è uguale a 0
26
Sono presenti tante sezioni quanti sono i documenti definiti nel tag NumeroDocumenti
22/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempi Obbligator
o
io
destinatario del
documento
Urn
Identificatore del
documento in NoTIER
1024 caratteri max
DataRicezioneNot Data e ora assegnata da
ier
NoTIER al momento del
ricevimento del
documento27
UrnCollegato
Identificatore del
documento collegato.
Stringa
SI
Data
1024 caratteri max
Stringa
Ad esempio nel caso di
una notifica è la fattura
a cui si riferisce
StatoGiacenza
urn:not
ier:IOR
G001:20
14:2_8
5:FATT
URA
Stato in cui si trova la
Valori ammessi:
sessione di ricezione del
DA_RECAPITARE
documento
RECAPITATO
SI
urn:not
ier:IOR
G001:20
14:2_8
5:FATT
URA
NO
Tipo
predefinito
NO
Tipo
predefinito
NO
IN_LAVORAZIONE
StatoConservazio
ne
Stato in cui si trova la
sessione di invio in
conservazione
Valori ammessi:
IN_ATTESA_DATI_FISCALI
DA_INVIARE
INVIATO_OK
INVIATO_KO
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Chiave> [1..1]
Mittente
Codice identificativo del
mittente del documento
50 caratteri max
Stringa
SOGG-001
SI
TipoMittente
Definisce la tipologia di
codice presente nel
Valori ammessi:
Tipo
predefinit
o
NOTIER
SI
Anno
Anno del documento
4 caratteri
Numerico
2014
SI
Numero
50 caratteri max
Stringa
1/8
SI
TipoDocumento
Tipologia di documento
Valori ammessi:
Tipo
predefinit
FATTURA
SI
NOTIER
FATTURA
27
NotiER gestisce un numero di versione associato ai Documenti, nel caso di Documento con
chiave Duplicata (nel caso delle fatture, questo caso comprende anche le fatture ex. Art 73) il
servizio di recupero restituisce solo l’ultima versione, pertanto la data di ricezione è
quella relativa all’ ultima versione dello stesso.
23/78
Tag XML
Descrizione
Vincoli
NOTA_DI_CREDITO
Tipo
dato
Esempi Obbligator
o
io
o
DOCUMENTO_DI_TRASPORTO
ORDINE
NOTIFICA_MDN28
NOTIFICA_DI_SCARTO
RICEVUTA_DI_CONSEGNA
NOTIFICA_DI_MANCATA_CONSEGNA
NOTIFICA_DI_ESITO_COMMITTENTE
NOTIFICA_DI_ESITO_CEDENTE
NOTIFICA_SCARTO_ESITO_COMMITTE
NTE
NOTIFICA_DI_DECORRENZA_TERMINI
ATTESTAZIONE_DI_FILE_NON_RECAPI
TABILE
NOTIFICA_METADATI_FILE_FATTURA
ESITO_CONSERVAZIONE29
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Chiave>
Inizio sezione
<EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Rappresentazione>
[1..1]
Formato
Valori ammessi:
- UBL
Tipo
predefinito
UBL
SI
Stringa
1.0
SI
- SDI
- PARER
Versione
Versione del formato del 10 caratteri max
documento
Fine sezione
<EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Rappresentazione>
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>
28
Tale Notifica (Message Delivery Notification) specifica solo l’esito dell’Invio di un
Documento ad un Access Point remoto tramite PEPPOL BusDox. L’infrastruttura PEPPOL, a
differenza di SDI, non prevede infatti l’esistenza di documenti riconducibili ad una Notifica di
Esito di Accettazione o Rifiuto.
Pertanto Documenti come Ordine e DDT non sono associabili ad un relativo Stato
Accettato o Rifiutato, come avviene invece per la Fatture/NdC veicolate da e verso SDI.
29
Viene reso disponibile l’Esito di Versamento così come viene restituito da ParER all’ atto del
versamento di un Documento Principale effettuato da NoTIER. Tale Documento è quindi
conforme allo schema ParER WSResponseVersamento.xsd
24/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempi Obbligator
o
io
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>
Fine sezione <EsitoRichiesta>/<ListaDocumenti>
Inizio sezione <EsitoRichiesta>
Codice
ERR-000-GENERICO
Descrizione
ERR-RECDOC-000RICHIESTA-NON-VALIDA
Indica che la richiesta non è valida. La causa dell’ errore verrà
dettagliata
nel
tag
e
dipende
generalmente dal nome dei parametri errato o da valori non
congruenti (valori di paginazione o date di inizio e fine invertite
etc..)
ERR-RECDOC-001-NONAUTORIZZATO
certificato X.509 non è autorizzato a richiamare il servizio
6 Servizio di recupero documento
Il servizio di recupero documento consente al chiamante di recuperare i
Documenti di propria competenza corrispondenti all’URN specificato, con la
sola eccezione di quelli attualmente in stato “In Lavorazione” e i
relativi documenti collegati.
25/78
6.1
URL
GET https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/
{urn_documento}
6.2
Richiesta
La request deve essere una GET HTTP verso l'indirizzo specificato nel
Paragrafo 6.1 Il chiamante deve sostituire la stringa {urn_documento} con
l’URN del Documento di propria competenza ricavabile dalla lista di Documenti
estratta come descritto al Paragrafo 5.
N.B.: è altamente sconsigliato cercare di dedurre l’URN del documento con
una qualsiasi logica (ad esempio, ricavare la Notifica dei Metadati di una
determinata
Fattura
sostituendo
la
stringa
FATTURA
con
NOTIFICA_METADATI_FILE_FATTURA nell’URN della fattura stessa), in quanto la
logica della creazione dell’URN di un documento potrebbe variare nel tempo in
base a nuove esigenze di business. Il metodo corretto per recuperare un
determinato documento è sempre quello di scaricare prima la lista dei
documenti (vedi Paragrafo 5) e successivamente invocare puntualmente il
Servizio di recupero documento.
6.3
Risposta
NoTIER risponde inviando il documento richiesto.
Se NoTIER non è in grado di risalire al documento avente URN specificata in
request perché non esiste un documento con tale URN o perché il client non è
autorizzato al recupero di tale documento, NoTIER risponde con codice HTTP
404 e fornisce nel payload di risposta un XML (“EsitoRichiesta”) con i dettagli
dell’errore.
6.3.1 Formato dell'XML di risposta
L'XML di risposta prodotto in caso di esito negativo è descritto
dall’XSD “EsitoRisposta” versione 1.0. Segue una descrizione dei
campi dichiarati all'interno dello schema.
26/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempi Obbli
o
gator
io
Versione
Versione dell'XML di
esito risposta
10 caratteri max
Stringa
1.0
SI
CodiceEsito
Esito della richiesta
Valori ammessi:
- KO
CodiceErrore
Definisce il codice
dell'errore
DescrizioneErrore Descrizione dell'errore
Tipo
predefinito
SI
Tipo
predefinito
SI
Stringa
SI
Fine sezione <EsitoRichiesta>
6.3.2 Codici di errore
Codice
ERR-000-GENERICO
Descrizione
ERR-RECDOC-001-NONAUTORIZZATO
certificato X.509 non è autorizzato a richiamare il servizio, oppure l’
urn specificato non è di competenza del chiamante, oppure il
Documento richiesto si trova in uno stato non compatibile con il
recupero (Es. “In Elaborazione”.
ERR-RECDOC-002-NONTROVATO
Indica che non esiste nessun documento in NoTIER corrispondente
all’ Urn specificato.
7 Integrazione Dati Fiscali
Il servizio di Integrazione consente al chiamante di integrare Documenti già
presenti in NoTIER con i dati fiscalmente rilevanti richiesti al fine di effettuare
27/78
l’Invio del Documento in Conservazione (PARER). Attualmente il servizio
supporta solamente l’Integrazione da parte del chiamante delle
fatture di ciclo passivo30, ossia le fatture di cui il chiamante stesso è
destinatario e che pervengono a NoTIER esclusivamente da SDI (ed
eventualmente da PEPPOL qualora gli emittenti risiedano in stati esteri).
Tale servizio non si applica alla conservazione dei Documenti di tipo
Ordini e Documenti di Trasporto.
7.1 URL
POST https://<host-NoTIER>:<portaNoTIER>/notier/rest/v1.0/documenti/daticonservazione
7.2 Richiesta
La request deve essere una POST HTTP all’indirizzo specificato nel Paragrafo
Errore: sorgente del riferimento non trovata e deve:

Specificare un Request Header Content-Type di tipo “multipart/formdata”

Specificare un Payload identificato da un Payload Header ContentDisposition “form-data” come segue:
o Attributo name=“metadati” per l’XML con i Metadati
o Attributo filename valorizzato31

Come descritto nel Paragrafo 2.3, il Payload dovrà inoltre avere un
Payload Header Content-Type: application/xml; charset=UTF-8
44444 Formato XML dei Metadati di Richiesta
I
metadati
da
inviare
nella
richiesta
sono
descritti
dall'XSD
“InvioDatiIntegrazione” versione 1.0 Segue la descrizione dei campi dichiarati
all'interno dello schema.
30
NoTIER è in grado di integrare autonomamente le Fatture di ciclo attivo da inviare in
Conservazione
31
Il nome del file può essere qualunque
28/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio Obblig
atorio
Inizio Sezione < DatiConservazione> [1..1]
Versione dell'XML del
servizio di invio documento
Versione
10 caratteri max
Stringa
1.0
SI
Inizio sezione < DatiConservazione>/< Documento > [1..1]
Urn
RipetiIntegrazione
Identificatore del
documento presente in
NoTIER
1024 caratteri max
Booleano con il quale è
possibile indicare se
modificare i dati di
integrazione comunicati in
precedenza
Stringa
urn:notier:
ORG001:2014:2
_85:CA:FAT
TURA
SI
Boolean
True/false
NO
Fine sezione < DatiConservazione>/< Documento >
Inizio sezione < DatiConservazione>/< DatiRegistrazione > [1..1]
NumeroRegistrazione Numero di registrazione
del Documento assegnato
dal Destinatario32
50 caratteri max
Tipo
predefinit
o
4534
DataRegistrazione
Data di registrazione del
Documento assegnato dal
Destinatario
Registro
Identificativo del Registro
in cui il Documento viene
registrato dal Destinatario
50 caratteri max
Tipo
predefinit
o
Oggetto della Fornitura a
cui si riferisce il
DocumentoErrore:
sorgente del riferimento
non trovata
50 caratteri max
Tipo
FORN_INTE
predefinit RCENTER
o
OggettoFornitura
Scadenza
Data
Data di scadenza del
DocumentoErrore:
non trovata
RiferimentoContabile Nel caso di contabilità
finanziaria, indica gli
estremi dell’ impegno
indicato in Fattura o
documento contabile
equivalente Errore:
non trovata
SI
RG_001
Data
50 caratteri max
Tipo
predefinit
o
SI
SI
NO
NO
IMP_456
NO
32
Previsto Ex. Articolo 42. Si noti che la normativa è ancora in fase di Approvazione,
pertanto i campi e la relativa obbligatorietà potrebbero cambiare
29/78
Tag XML
Descrizione
TipoRifContabile
Vincoli
Tipo di Riferimento
Valori ammessi:
ContabileErrore: sorgente
- IMPEGNO
del riferimento non trovata
- CAPITOLO
Tipo
dato
Esempio Obblig
atorio
Tipo
predefinit
o
NO
Indica se la spesa a cui si
Valori ammessi:
riferisce il Documento
- SI
(Fattura Passiva) è rilevate
ai fini IVAErrore: sorgente - NO
Tipo
predefinit
o
NO
CIG
Indica il Codice
Identificativo di
GaraErrore: sorgente del
riferimento non trovata
50 caratteri max
Tipo
predefinit
o
GARA_345
NO
CUP
Indica il Codice Unico di
50 caratteri max
ProgettoErrore: sorgente
Tipo
predefinit
o
PROG_345
NO
- PIANO_GESTIONALE
RilevanzaIVA
DatiSpecifici
Ulteriori Metadati
Specifici33
Any
NO
Inizio sezione < DatiIntegrazione >/< DatiRegistrazione >/<Protocollo> [1..1]
NumeroProtocollo
DataProtocollo
Numero nel registro di
Protocollo assegnato dal
Destinatario
50 caratteri max
Data di riferimento del
numero di protocollo
assegnato dal Destinatario
Tipo
predefinito
PROT_53
SI
Data
SI
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<Protocollo>
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>
[0..1]34
Inizio sezione < DatiConservazione >/< DatiRegistrazione
>/<DocumentiCollegati>/< DocumentoCollegato> [1..n]
Inizio sezione < DatiConservazione >/< DatiRegistrazione
>/<DocumentiCollegati>/< DocumentoCollegato>/< ChiaveCollegamento > [1..1]
Numero
Numero di Registro del
Documento Collegato
100 caratteri max
Tipo
predefinito
NUM_7896
SI
33
Set di metadati specifici aggiuntivi rispetto a quelli standard che il chiamante del servizio di
integrazione ritiene opportuno inviare in Conservazione. Tale set va concordato
preventivamente con PARER.
34
Riferimenti ad eventuali Documenti Collegati già inseriti in precedenza in Conservazione e di
cui si hanno i riferimenti che Parer ha restituito al chiamante come esito dell’ archiviazione.
30/78
Tag XML
Anno
Descrizione
Anno di registrazione
Vincoli
4 caratteri
100 caratteri max
TipoRegistro
Tipo
dato
Esempio Obblig
atorio
Numerico
Tipo
predefinito
SI
REG_ACQUI
STI
SI
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>/<
DocumentoCollegato>/< ChiaveCollegamento >
DescrizioneCollegame Descrizione del Documento
nto
Collegato
256 caratteri max
Tipo
predefinito
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>/<
DocumentoCollegato>
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>
[0..1]
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/<
FascicoloPrincipale > [1..1]
Classifica
Classificazione del fascicolo
256 caratteri max
Tipo
predefinito
NO
FascicoloPrincipale > / < Fascicolo > [0..1]
Identificativo
Oggetto
Identificativo del Fascicolo
Principale
Oggetto del Fascicolo
Principale
100 caratteri max
Tipo
predefinito
SI
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/<
FascicoloPrincipale > / < Fascicolo >
FascicoloPrincipale > / <SottoFascicolo > [0..1]
Identificativo
Identificativo del
SottoFascicolo
Oggetto del SottoFascicolo
Oggetto
100 caratteri max
Tipo
predefinito
SI
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
FascicoloPrincipale > / <SottoFascicolo >
31/78
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio Obblig
atorio
FascicoloPrincipale>
FascicoliSecondari> [0..1]
FascicoliSecondari> / < FascicoloSecondario> [1..n]
Classificazione del
Fascicolo Secondario
Classifica
256 caratteri max
Tipo
predefinito
NO
FascicoliSecondari> / > / < FascicoloSecondario> / < Fascicolo > [0..1]
Identificativo
Identificativo del Fascicolo
Secondario
Oggetto del Fascicolo
secondario
Oggetto
100 caratteri max
Tipo
predefinito
SI
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
FascicoliSecondari> / < FascicoloSecondario> / < Fascicolo >
FascicoliSecondari> / < FascicoloSecondario> / <SottoFascicolo > [0..1]
Identificativo
Oggetto
Identificativo del
SottoFascicolo Secondario
100 caratteri max
Tipo
predefinito
SI
Oggetto del SotoFascicolo
Secondario
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
FascicoliSecondari> / < FascicoloSecondario> / <SottoFascicolo >
FascicoliSecondari> / < FascicoloSecondario>
FascicoliSecondari>
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>
Fine sezione < DatiConservazione >/< DatiRegistrazione >
Fine sezione < DatiConservazione >
32/78
7.3 Risposta
NoTIER fornisce in risposta l’esito dell’operazione di invio in formato XML. Essa
riporta, in caso di in caso di esito negativo il codice d'errore e la relativa
descrizione.
44444 Formato del file XML di risposta
Tag XML
Descrizione
Vincoli
Tipo
dato
Esempio
Obbli
gatori
o
1.0
SI
Versione
Versione dell'XML di esito
risposta
10 caratteri max
Stringa
CodiceEsito
Esito della richiesta. Vale
Valori ammessi:
OK in caso di esito positivo,
- OK
KO in caso di esito
negativo
- KO
Tipo
predefinito
SI
CodiceErrore
Definisce il codice
dell'errore 35
Presente se
CodiceEsito=KO
Tipo
predefinito
NO
DescrizioneErrore
Descrizione dell'errore
Presente se
CodiceEsito=KO
Stringa
NO
Codice
ERR-000-GENERICO
35
Descrizione
33/78
Codice
Descrizione
ERR-CONSDOC-000RICHIESTA-NON-VALIDA
Indica che la richiesta non è valida. La causa dell'errore, dettagliata
nel tag descrizioneErrore, è la mancanza dell'XML dei metadati.
ERR-CONSDOC-001-XMLNON-VALIDO
Indica che l'XML dei metadati non è valido.
L'errore si ottiene al verificarsi di in una delle seguenti condizioni:

l'XML non è valido rispetto l'XSD di InvioDocumento nella
versione specificata.
ERR-CONSDOC-002-NONAUTORIZZATO
certificato X.509 non è autorizzato a richiamare il servizio oppure
non è autorizzato a richiedere l’ integrazione del documento
specificato nel tag <DatiConservazione >/<Documento>/< Urn
>
ERR-CONSDOC-003-NONTROVATO
Indica che il Documento specificato dal tag
ERR-CONSDOC-004-NONAPPLICABILE
Indica che per il tipo di Documento specificato dal tag
<DatiConservazione >/<Documento>/< Urn > non è
applicabile il servizio di Integrazione 36
<DatiConservazione >/<Documento>/< Urn > non è presente
in NoTIER
8 Conservazione Ordini e DDT
Il versamento in conservazione di Ordini e documenti di trasporto è effettuato
automaticamente da NoTIER alle seguenti condizioni:

CICLO ATTIVO: il documento risulta correttamene inviato all’Access
Point ricevente tramite rete BUSDOX, cioè al ricevimento di una
notifica MDN con esito OK

CICLO PASSIVO: il documento risulta correttamente ricevuto da
NoTIER.
36
Attualmente l’ errore si verifica nel caso in cui il Documento non è di Ciclo Passivo e/o si
trova in uno stato che non consenta l’ integrazione (Ad esempio è ancora tra trasformare da
SDI a UBL, oppure il Documento stesso è già stato integrato in precedenza)
34/78
In entrambi i casi il versamento è effettuato componendo autonomamente i
metadati37 di conservazione a partire dai dati contenuti nell’XML del
documento.
37
Tali metadati sono ancora in corso di definizione.
35/78
Appendice A – Esempi di Invocazione dei Servizi noTIER
A.1
Invio Documento di tipo Fattura SDI con Esito Positivo
A.1.1 Esempio di request HTTP con invio dei file di metadati e del documento
Header
POST /notier/rest/v1.0/documenti/invio/ HTTP/1.1
Host: host.client.it:8080
Accept: application/xml,text/xml
Accept-Encoding: gzip, deflate
Content-Type: multipart/form-data; boundary=--AaB03x
Payload
--AaB03x
Content-Disposition: form-data; name="metadati"; filename=”metadati.xml”
Content-Type: application/xml; charset=UTF-8
<?xml version="1.0" encoding="utf-8"?>
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/request"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://notier.intercenter.rer.it/services/request InvioDocumento.xsd">
<Versione>1.0</Versione>
<Documento>
<Chiave>
<Mittente>IT0123456789</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2014</Anno>
<Numero>1/80</Numero>
<TipoDocumento>FATTURA</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>UBL</Formato>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>true</InvioSdi>
<InvioPeppol>false</InvioPeppol>
<InvioConservazione>true</InvioConservazione>
<ApprovazioneAutomatica>true</ApprovazioneAutomatica>
<AccettaChiaveDuplicata>true</AccettaChiaveDuplicata>
</Configurazione>
<Integrazione>
<Registro>Reg.Acq</Registro>
</Integrazione>
</InvioDocumento>
--AaB03x
Content-Disposition: form-data; name="documento"; filename=”documento.xml”
Content-Type: application/xml; charset=UTF-8”
<Invoice> ... </Invoice>
A.1.2 File XML “metadati”
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request">
<Documento>
<Chiave>
<Mittente>org0002</Mittente>
<Anno>2014</Anno>
</Chiave>
<Rappresentazione>
<Formato>SDI</Formato>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>true</InvioSdi>
<InvioPeppol>false</InvioPeppol>
<ApprovazioneAutomatica>true</ApprovazioneAutomatica>
<AccettaChiaveDuplicata>false</AccettaChiaveDuplicata>
</Configurazione>
<Integrazione>
</Integrazione>
</InvioDocumento>
B.1.3 File XML “documento”
Per un esempio di Fattura in formato SDI 1.1 fare riferimento al sito FatturaPA
http://www.fatturapa.gov.it/export/fatturazione/it/normativa/f-2.htm
B.1.4 File XML di Esito Risposta
<EsitoRichiesta xmlns=" http://notier.intercenter.rer.it/services/1.0/esito/response"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Esito>
<CodiceEsito>OK</CodiceEsito>
</Esito>
<Documento>
<Urn>urn:notier:org002:2014:456_14:CA:FATTURA</Urn>
<DataRicezioneNotier>2014-04-01 00:00:00</DataRicezioneNotier>
<Chiave>
<Anno>2014</Anno>
</Chiave>
<Rappresentazione>
</Rappresentazione>
</Documento>
</EsitoRichiesta>
A.2
Invio Documento di tipo Fattura PEPPOL con Esito Negativo
A.2.1 File xml “metadati”
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request"
<Documento>
<Chiave>
<Anno>2014</Anno>
</Chiave>
<Rappresentazione>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>false</InvioSdi>
<InvioPeppol>true</InvioPeppol>
<InvioConservazione>false</InvioConservazione>
<ApprovazioneAutomatica>false</ApprovazioneAutomatica>
</Configurazione>
<Integrazione>
</Integrazione>
<MetadatiBusdox>
<RecipientIdentifier>9906:11223344</RecipientIdentifier>
<SenderIdentifier>9906:1234567</SenderIdentifier>
<DocumentIdentifier> urn:oasis:names:specification:ubl:schema:xsd:Invoice2::Invoice##urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol5a:ver2.0:extended:urn:www.ublitalia.org:spec:fatturapa:ver2.0::2.1</DocumentIdentifier>
<ProcessIdentifier> urn:www.cenbii.eu:profile:bii05:ver2.0</ProcessIdentifier>
</MetadatiBusdox>
</InvioDocumento>
A.2.2 File xml “documento”
Fare riferimento al Paragrafo
<Invoice xmlns:Invoice="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
(…)
</Invoice >
A.2.3 File xml di Esito Risposta
<Esito>
<CodiceEsito>KO</CodiceEsito>
<CodiceErrore>ERR-INVIODOC-008-DOC-NON-VALIDO-SCHEMATRON</CodiceErrore>
<DescrizioneErrore>La validazione Schematron UBL 2.0 ha restituito un numero di Errori Fatali superiore al massimo
consentito</DescrizioneErrore>
</Esito>
</EsitoRichiesta>
A.3 Invio Documento di tipo Documento di Trasporto a PEPPOL con esito
Positivo
A.3.1 File xml “metadati”
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request"
<Documento>
<Chiave>
<Anno>2015</Anno>
<Numero>005</Numero>
<TipoDocumento>DOCUMENTO_DI_TRASPORTO</TipoDocumento>
</Chiave>
<Rappresentazione>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>false</InvioSdi>
<InvioPeppol>true</InvioPeppol>
<ApprovazioneAutomatica>false</ApprovazioneAutomatica>
</Configurazione>
<Collegamento>
<urn> urn:notier:org020:2015:001:CP:ORDINE:03</urn>
</Collegamento>
<MetadatiBusdox>
<RecipientIdentifier>9906:11223344</RecipientIdentifier>
<SenderIdentifier>9906:1234567</SenderIdentifier>
<DocumentIdentifier>urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice2::DespatchAdvice##urn:www.cenbii.eu:transaction:biitrns016:ver1.0:extended:urn:www.peppol.eu:bis:peppol30a:ver1.0::2.1</DocumentId
entifier>
<ProcessIdentifier> urn:www.cenbii.eu:profile:bii03:ver2.0</ProcessIdentifier>
</MetadatiBusdox>
</InvioDocumento>
A.2.2 File xml “documento”
<DespatchAdvice xmlns=" urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-2 "
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
(…)
</ DespatchAdvice>
<Esito>
</Esito>
<Documento>
<Urn>urn:notier:org0002:2015:005:CA:DOCUMENTO_DI_TRASPORTO:01</Urn>
<DataRicezioneNotier>2015-01-01 00:00:00</DataRicezioneNotier>
<Chiave>
<Anno>2015</Anno>
<TipoDocumento> DOCUMENTO_DI_TRASPORTO</TipoDocumento>
</Chiave>
<Rappresentazione>
</Rappresentazione>
</Documento>
</EsitoRichiesta>
A.4 Recupero Notifiche
destinatario specificato
di
Esito
in
Stato
A.4.1 Query String di Invocazione del Servizio
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/?
idnotier=org001&tipodoc=NOTIFICA_DI_ESITO&stato=DA_RECAPITARE
“Da
recapitare”
per
un
<Esito>
</Esito>
<ListaDocumenti>
<NumeroDocumenti>1</NumeroDocumenti>
<Documenti>
<Documento>
<Destinatario>org001</Destinatario>
<Urn>urn:notier:org020:2014:567:CP:NOTIFICA _DI_ESITO_COMMITTENTE</Urn>
<DataRicezioneNotier>2014-03-15</DataRicezioneNotier>
<StatoGiacenza>DA_RECAPITARE</StatoGiacenza>
<UrnCollegato>urn:notier:org001:2014:11_2013:CP:FATTURA</UrnCollegato>
<Chiave>
<Mittente>org-org020</Mittente>
<Anno>2014</Anno>
<TipoDocumento>NOTIFICA _DI_ESITO_COMMITTENTE</TipoDocumento>
</Chiave>
<Rappresentazione>
</Rappresentazione>
</Documento>
</Documenti>
</ListaDocumenti>
</EsitoRichiesta>
A.5
Recupero Documento con Esito Negativo
https://<host-NoTIER>:<portaNoTIER>/notier/rest/v1.0/documenti/recupero/urn:notier:org020:2014:568:CP:NOTIFICA_DI_ESITO_COMMITTENTE
<EsitoRichiesta xmlns="http://notier.intercenter.rer.it/services/1.0/esito/response "
xsi:schemaLocation="http://notier.intercenter.rer.it/services/response ">
<Esito>
<CodiceErrore>ERR-RECDOC-000-NON-TROVATO</CodiceErrore>
<DescrizioneErrore>Documento urn:notier:org020:2014:568:CP:NOTIFICA_DI_ESITO_COMMITTENTE non trovato</DescrizioneErrore>
</Esito>
</EsitoRichiesta>
A.6
Recupero di Notifica MDN
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/
urn:notier:org0002:2015:005:CA:NOTIFICA_MDN:01
A.6.2 File xml di Esito Positivo
<NotificaMDN xmlns="http://notier.intercenter.rer.it/services/1.0/notificaMDN"
xsi:schemaLocation="http://notier.intercenter.rer.it/services/1.0/notificaMDN">
<Esito>
<Documento>
<RecipientID> 9906:11223344</RecipientID>
<DocumentID>urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice2::DespatchAdvice##urn:www.cenbii.eu:transaction:biitrns016:ver1.0:extended:urn:www.peppol.eu:bis:peppol30a:ver1.0:extended:urn:www
.ubl-italia.org:spec:ddt:ver2.1::2.1</DocumentID>
</Documento>
<EsitoMDN>
<MessageID>490c31d4-49a7-471b-93de-bf95f843515b</MessageID>
<TransmissionID>d0a68c6f-0e00-49d3-a380-37b94d73890c</TransmissionID>
</EsitoMDN>
<EsitoTrasmissione>
</EsitoTrasmissione>
</Esito>
</ NotificaMDN >
A.6.3 File xml di Esito Negativo
<NotificaMDN xmlns="http://notier.intercenter.rer.it/services/1.0/notificaMDN"
xsi:schemaLocation="http://notier.intercenter.rer.it/services/1.0/notificaMDN">
<Esito>
<Documento>
<RecipientID> 9906:11223344</RecipientID>
<DocumentID>urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice2::DespatchAdvice##urn:www.cenbii.eu:transaction:biitrns016:ver1.0:extended:urn:www.peppol.eu:bis:peppol30a:ver1.0:extended:urn:www
.ubl-italia.org:spec:ddt:ver2.1::2.1</DocumentID>
</Documento>
<EsitoMDN/>
<EsitoTrasmissione>
<DescrizioneErrore>Errore</DescrizioneErrore>
</EsitoTrasmissione>
</Esito>
</ NotificaMDN >
A.7
Integrazione Dati Fiscali con esito positivo
A.7.1 File XML “metadati”
<DatiIntegrazione xmlns=" http://notier.intercenter.rer.it/services/1.0/daticonservazione/request"
<Documento>
<Urn>urn:notier:org002:2014:456_14:CA:FATTURA</Urn>
</Documento>
<DatiRegistrazione>
<NumeroRegistrazione>REG_3456</NumeroRegistrazione>
<DataRegistrazione>2014-03-15</DataRegistrazione>
<Registro>45</Registro>
<Protocollo>
<NumeroProtocollo>8877</NumeroProtocollo>
<AnnoProtocollo>2014</AnnoProtocollo>
</Protocollo>
<OggettoFornitura>CONTRATTO_67</OggettoFornitura>
<Scadenza>2014-09-15</Scadenza>
<RiferimentoContabile>RIF_56</RiferimentoContabile>
<TipoRifContabile>IMPEGNO</TipoRifContabile>
<RilevanzaIVA>SI</RilevanzaIVA>
</DatiRegistrazione>
</DatiIntegrazione>
A.7
Recupero di Esito Versamento con Esito Positivo
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/
ESITO_CONSERVAZIONE
A.7.2 File XML di Esito Risposta
<?xml version="1.0" encoding="UTF-8"?>
<EsitoVersamento>
<VersioneXMLChiamata>1.4</VersioneXMLChiamata>
<DataVersamento>2015-10-09T13:36:01.166+02:00</DataVersamento>
urn:notier:org0002:2015:005:CA:
<EsitoGenerale>
<CodiceEsito>POSITIVO</CodiceEsito>
<CodiceErrore/>
<MessaggioErrore/>
</EsitoGenerale>
<EsitoChiamataWS>
<VersioneWSCorretta>POSITIVO</VersioneWSCorretta>
<CredenzialiOperatore>POSITIVO</CredenzialiOperatore>
<FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti>
</EsitoChiamataWS>
<EsitoXSD>
<ControlloStrutturaXML>POSITIVO</ControlloStrutturaXML>
<UnivocitaIDComponenti>POSITIVO</UnivocitaIDComponenti>
<UnivocitaIDDocumenti>POSITIVO</UnivocitaIDDocumenti>
<CorrispondenzaAllegatiDichiarati>POSITIVO</CorrispondenzaAllegatiDichiarati>
<CorrispondenzaAnnessiDichiarati>POSITIVO</CorrispondenzaAnnessiDichiarati>
<CorrispondenzaAnnotazioniDichiarate>POSITIVO</CorrispondenzaAnnotazioniDichiarate>
</EsitoXSD>
<Configurazione>
<TipoConservazione>FISCALE</TipoConservazione>
<ForzaAccettazione>true</ForzaAccettazione>
<ForzaConservazione>false</ForzaConservazione>
<ForzaCollegamento>true</ForzaCollegamento>
<AbilitaControlloCrittografico>true</AbilitaControlloCrittografico>
<AbilitaControlloTrust>true</AbilitaControlloTrust>
<AbilitaControlloCertificato>true</AbilitaControlloCertificato>
<AbilitaControlloCRL>true</AbilitaControlloCRL>
<AbilitaControlloFormato>true</AbilitaControlloFormato>
<AccettaFirmaSconosciuta>true</AccettaFirmaSconosciuta>
<AccettaFirmaNonConforme>true</AccettaFirmaNonConforme>
<AccettaMarcaSconosciuta>true</AccettaMarcaSconosciuta>
<AccettaControlloCrittograficoNegativo>false</AccettaControlloCrittograficoNegativo>
<AccettaControlloTrustNegativo>true</AccettaControlloTrustNegativo>
<AccettaControlloCertificatoScaduto>true</AccettaControlloCertificatoScaduto>
<AccettaControlloCertificatoNoValido>true</AccettaControlloCertificatoNoValido>
<AccettaControlloCertificatoNoFirma>true</AccettaControlloCertificatoNoFirma>
<AccettaControlloCRLNegativo>true</AccettaControlloCRLNegativo>
<AccettaControlloCRLScaduta>true</AccettaControlloCRLScaduta>
<AccettaControlloCRLNoValida>true</AccettaControlloCRLNoValida>
<AccettaControlloCRLNoScaric>true</AccettaControlloCRLNoScaric>
<AccettaControlloFormatoNegativo>true</AccettaControlloFormatoNegativo>
</Configurazione>
<UnitaDocumentaria>
<Versatore>
<Ambiente>PARER</Ambiente>
<Ente>ORG-000</Ente>
<Struttura>UFF-0000</Struttura>
<UserID>user</UserID>
</Versatore>
<Chiave>
<Anno>2015</Anno>
<TipoRegistro>V13</TipoRegistro>
</Chiave>
<DataVersamento>2015-10-09T13:36:01.166+02:00</DataVersamento>
<StatoConservazione>IN_ATTESA_SCHED</StatoConservazione>
<FirmatoDigitalmente>true</FirmatoDigitalmente>
<EsitoUnitaDocumentaria>
<IdentificazioneVersatore>POSITIVO</IdentificazioneVersatore>
<UnivocitaChiave>POSITIVO</UnivocitaChiave>
<VerificaTipologiaUD>POSITIVO</VerificaTipologiaUD>
<CorrispondenzaDatiSpecifici>POSITIVO</CorrispondenzaDatiSpecifici>
<PresenzaUDCollegate>POSITIVO</PresenzaUDCollegate>
<VerificaFirmeUnitaDocumentaria>POSITIVO</VerificaFirmeUnitaDocumentaria>
</EsitoUnitaDocumentaria>
<DocumentoPrincipale>
<ChiaveDoc>V13-2015-4/13-PRINCIPALE-1</ChiaveDoc>
<IDDocumento>/ urn:notier:org0002:2015:005:CA: FATTURA:SDI</IDDocumento>
<EsitoDocumento>
<VerificaTipoDocumento>POSITIVO</VerificaTipoDocumento>
<CorrispondenzaDatiFiscali>POSITIVO</CorrispondenzaDatiFiscali>
<VerificaTipoStruttura>POSITIVO</VerificaTipoStruttura>
<VerificaFirmeDocumento>POSITIVO</VerificaFirmeDocumento>
<UnivocitaOrdinePresentazione>POSITIVO</UnivocitaOrdinePresentazione>
</EsitoDocumento>
<Componenti>
<Componente>
<OrdinePresentazione>1</OrdinePresentazione>
<TipoComponente>Contenuto</TipoComponente>
<URN>urn:PARER</URN>
<Hash>89E9A90CF0F07D091E27E54C7C87E90B6925C9B0</Hash>
<AlgoritmoHash>SHA-1</AlgoritmoHash>
<Encoding>hexBinary</Encoding>
<FormatoRappresentazione>XML.P7M</FormatoRappresentazione>
<FormatoRappresentazioneEsteso>XML.P7M</FormatoRappresentazioneEsteso>
<IdoneitaFormato>IDONEO</IdoneitaFormato>
<DimensioneFile>6164</DimensioneFile>
<EsitoComponente>
<VerificaTipoComponente>POSITIVO</VerificaTipoComponente>
<VerificaTipoSupportoComponente>POSITIVO</VerificaTipoSupportoComponente>
<VerificaTipoRappresentazione>POSITIVO</VerificaTipoRappresentazione>
<VerificaNomeComponente>POSITIVO</VerificaNomeComponente>
<VerificaAmmissibilitaFormato>POSITIVO</VerificaAmmissibilitaFormato>
<VerificaRiconoscimentoFormato>POSITIVO</VerificaRiconoscimentoFormato>
<MessaggioRiconoscimentoFormato>Controllo OK</MessaggioRiconoscimentoFormato>
<VerificaFirmeComponente>POSITIVO</VerificaFirmeComponente>
</EsitoComponente>
<Firmatari>
<Firmatario>
<OrdineFirma>1</OrdineFirma>
<CognomeNome>CN Firmatario</CognomeNome>
<FormatoFirma>CADES_BES</FormatoFirma>
<RiferimentoTemporaleUsato>2015-1009T07:16:43.000+02:00</RiferimentoTemporaleUsato>
<TipoRiferimentoTemporaleUsato>DATA_FIRMA</TipoRiferimentoTemporaleUsato>
<EsitoFirma>
<ControlloConformita>POSITIVO</ControlloConformita>
<DettaglioControlloConformita>Formato riconosciuto e
conforme</DettaglioControlloConformita>
<VerificaFirma>
OK</DettaglioControlloCrittografico>
<ControlloCrittografico>POSITIVO</ControlloCrittografico>
<DettaglioControlloCrittografico>Controllo
<ControlloCatenaTrusted>POSITIVO</ControlloCatenaTrusted>
<ControlloCertificato>POSITIVO</ControlloCertificato>
<DettaglioControlloCertificato>Controllo OK</DettaglioControlloCertificato>
<ControlloCRL>POSITIVO</ControlloCRL>
<DettaglioControlloCRL>Controllo OK</DettaglioControlloCRL>
</VerificaFirma>
</EsitoFirma>
</Firmatario>
</Firmatari>
<SottoComponenti>
<SottoComponente>
<OrdinePresentazione>2</OrdinePresentazione>
<TipoComponente>Foglio di trasformazione</TipoComponente>
<URN>urn:PARER</URN>
<EsitoSottoComponente>
<VerificaTipoComponente>POSITIVO</VerificaTipoComponente>
<VerificaTipoSupportoComponente>POSITIVO</VerificaTipoSupportoComponente>
</EsitoSottoComponente>
</SottoComponente>
</SottoComponenti>
</Componente>
</Componenti>
</DocumentoPrincipale>
</UnitaDocumentaria>
</EsitoVersamento>
A.8
Metadati PEPPOL
I valori di DocumentID da specificare nei Metadati di Invio sono espressi nel seguente formato:
rootNamespace::localname##CustomizationID::Version
come previsto dal Documento “PEPPOL Policy for use of Identifiers”, Versione 3.0 38
Il valore di CustomizationID è invece quello previsto dalle specifiche relative alla localizzazione Italiana dei Documenti PEPPOL, reperibile sul
sito di IntercentER39
38
Attualmente reperibili su https://joinup.ec.europa.eu/svn/peppol/TransportInfrastructure/PEPPOL_Policy%20for%20use%20of%20identifiers-300.pdf
39
Attualmente reperibili su http://intercenter.regione.emilia-romagna.it/aree/dematerializzazione-acquisti/infografica-p-a/p-a/dematerializzazione-degli-acquisti-sezione-p-a
Tabella relativa ai valori di ProfileID e Document ID da specificare nei Metadati in caso di invio un Documento a PEPPOL BusDox
TIPO
PROFILE ID
DOCUMENT ID
Fattur
a
urn:www.cenbii.eu:profile:bii05:
ver2.0
urn:oasis:names:specification:ubl:schema:xsd:Invoice2::Invoice##urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol5a:ver2.0:extended:urn:www.ublitalia.org:spec:fatturapa:ver2.0::2.1
Nota
di
Credit
ver2.0
urn:oasis:names:specification:ubl:schema:xsd:CreditNote2::CreditNote##urn:www.cenbii.eu:transaction:biitrns014:ver2.0:extended:urn:www.peppol.eu:bis:peppol5a:ver2.0:extended:urn:www.
ubl-italia.org:spec:fatturapa:ver2.0::2.1
o
Ordin
e
ver2.0
urn:oasis:names:specification:ubl:schema:xsd:Order2::Order##urn:www.cenbii.eu:transaction:biitrns001:ver2.0:extended:urn:www.peppol.eu:bis:peppol3a:ver2.0:extended:urn:www.ublitalia.org:spec:ordine:ver2.1::2.1
DDT
ver2.0
urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice2::DespatchAdvice##urn:www.cenbii.eu:transaction:biitrns016:ver1.0:extended:urn:www.peppol.eu:bis:peppol30a:ver1.0:extended:urn
:www.ubl-italia.org:spec:ddt:ver2.1::2.1
Esempio di Metadati PEPPOL per l’ invio di una Fattura
Esempio di Metadati PEPPOL per l’ invio di un Documento di Trasporto

NoTIER Specifiche tecniche servizi - Intercent-ER

Transcript

Documenti analoghi

Esito ricerche 2012 – Programmatore COBOL e PL/SQL SENIOR

Vendita - 6 locali EZE VILLAGE

Fattura Elettronica - AZIENDE

Guida per la fatturazione elettronica - Intercent-ER

Vendita - Quadrilo MONACO

Considerazioni sui marche/modelli di memorie Compact Flash

Piano Strategico ICT sanità

Esercizi di codifica XML

I linguaggi di marcatura e XML per la codifica dei dati d`archivio