NoTIER Specifiche
tecniche servizi
Specifiche tecniche servizi invio
e recupero documenti
NOTIER_AT_SpecificheServizi_v1.15_finale
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
4.4
Formato dell'XML dei metadati di richiesta ............................................................... 11
Risposta ................................................................................................................................ 15
4.4.1
URN ............................................................................................................................. 15
4.4.1.1
5
6
Casi Particolari..................................................................................... 15
4.4.2
Formato del file XML di risposta ................................................................................ 16
4.4.3
Codici di errore ........................................................................................................... 17
Servizio di recupero lista documenti .......................................................................................... 19
5.1
URL ....................................................................................................................................... 19
5.2
Richiesta ............................................................................................................................... 19
5.2.1
Formato dell'XML di risposta...................................................................................... 21
5.2.2
Codici di errore ........................................................................................................... 24
Servizio di recupero documento................................................................................................. 25
6.1
URL ....................................................................................................................................... 25
6.2
Richiesta ............................................................................................................................... 25
6.3
Risposta ................................................................................................................................ 25
6.3.1
Formato dell'XML di risposta...................................................................................... 26
6.3.2
Codici di errore ........................................................................................................... 26
NotiER – Specifiche tecniche servizi
2/55
NOTIER_AT_SpecificheServizi_v1.15_finale
7
Integrazione Dati Fiscali .............................................................................................................. 27
7.1
URL ....................................................................................................................................... 27
7.2
Richiesta ............................................................................................................................... 27
7.2.1
7.3
8
Formato XML dei Metadati di Richiesta .................................................................... 28
Risposta ................................................................................................................................ 32
7.3.1
Formato del file XML di risposta ................................................................................ 32
7.3.2
Codici di errore ........................................................................................................... 32
Conservazione Ordini e DDT ....................................................................................................... 33
Appendice A – Esempi di Invocazione dei Servizi noTIER .................................................................. 34
A.1 Invio Documento di tipo Fattura SDI con Esito Positivo ............................................................. 34
A.1.1 Esempio di request HTTP con invio dei file di metadati e del documento ..................... 34
A.1.2 File XML “metadati” .......................................................................................................... 36
B.1.3 File XML “documento” ...................................................................................................... 37
B.1.4 File XML di Esito Risposta .................................................................................................. 37
A.2 Invio Documento di tipo Fattura PEPPOL con Esito Negativo .................................................... 38
A.2.1 File xml “metadati” ............................................................................................................ 38
A.2.2 File xml “documento” ........................................................................................................ 39
A.2.3 File xml di Esito Risposta ................................................................................................... 40
A.3 Invio Documento di tipo Documento di Trasporto a PEPPOL con esito Positivo ....................... 40
A.3.1 File xml “metadati” ............................................................................................................ 40
A.2.2 File xml “documento” ........................................................................................................ 42
A.2.3 File xml di Esito Risposta ................................................................................................... 42
A.4 Recupero Notifiche di Esito in Stato “Da recapitare” per un destinatario specificato .............. 43
A.4.1 Query String di Invocazione del Servizio ........................................................................... 43
A.4.2 File xml di Esito Risposta ................................................................................................... 43
A.5 Recupero Documento con Esito Negativo .................................................................................. 44
A.5.1 Query String di Invocazione del Servizio ........................................................................... 44
A.5.2 File xml di Esito Risposta ................................................................................................... 44
A.6 Recupero di Notifica MDN con Esito Positivo............................................................................. 46
NotiER – Specifiche tecniche servizi
3/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.6.1 Query String di Invocazione del Servizio ........................................................................... 46
A.6.2 File xml di Esito .................................................................................................................. 46
A.7 Integrazione Dati Fiscali con esito positivo ................................................................................ 47
A.7.1 File XML “metadati” .......................................................................................................... 47
A.7 Recupero di Esito Versamento con Esito Positivo ..................................................................... 48
A.7.1 Query String di Invocazione del Servizio ........................................................................... 48
A.7.2 File XML di Esito Risposta .................................................................................................. 48
A.8 Metadati PEPPOL ........................................................................................................................ 53
NotiER – Specifiche tecniche servizi
4/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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:
NOTIER_AT_SpecificheServizi_v1.15.doc
Versione
1.0
Data
28/03/2014
Autore
Marco Quaranta
Cambiamenti apportati
Draft
Giuseppe Larosa
1.1
18/04/2014
Marco Quaranta
Prima stesura
1.2
28/04/2014
Marco Quaranta
Revisione Post-Incontro con 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
Modifiche in seguito a 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
Corretti URL dei servizi
Modificato
xsd
conservazione:
1.8
18/06/2014
Marco Quaranta
WS
campo
integrazione
dati
AnnoProtocollo
diventa Data Protocollo
Modificati i filtri del servizio di recupero lista
documenti: stato diventa statoConservazione
e statoGiacenza
NotiER – Specifiche tecniche servizi
5/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Inserita
versione
dei
documenti
UBL,
paragrafo 4.1
1.9
08/07/2014
Giuseppe Larosa
L’urn generato da Notier ha come separatore i
due punti “:”
Corrette le URL dei servizi
Rimossi in appendice gli XSD dei servizi
Precisazione
1.10
08/08/2014
Marco Quaranta
relativa
alla
necessità
di
specificare l’attributo filename nel contentdisposition del documento nel servizio di invio
documento. Allineato l’esempio in Appendice
1.11
28/08/2014
Rimossa nota numero 19
Corretto
attributo
content-disposition
1.12
03/09/2014
filename
nell’header
nell’esempio
in
Marco Quaranta
appendice. Corretto Refuso su Host in
Giuseppe Larosa
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 PEPPOL ,
1.15
06/10/2015
Larosa Giuseppe
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
NotiER – Specifiche tecniche servizi
6/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Schema XSD associati:
Nome
Versione
InvioDocumento.xsd
1.0
EsitoRichiesta.xsd
1.0
InvioDatiIntegrazione.xsd
1.0
NotificaMDN.xsd
1.0
WSResponseVersamento.xsd (Esito Versamento in ParER)
1.4
NotiER – Specifiche tecniche servizi
7/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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:
NotiER – Specifiche tecniche servizi
8/55
NOTIER_AT_SpecificheServizi_v1.15_finale

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, PEPPOL-BusDox 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.
NotiER – Specifiche tecniche servizi
9/55
NOTIER_AT_SpecificheServizi_v1.15_finale
 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.emiliaromagna.it/servizi/modalita-tecniche-per-avviare-i-servizi-di-conservazione1
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:
 Specificare un Request Header Content-Type di tipo “multipart/form-data”
 Specificare un Payload composto da due parti, ciascuna identificata da un Payload Header
Content-Disposition “form-data” come segue:
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.
NotiER – Specifiche tecniche servizi
10/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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.
4.3.1 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
Obbligat
orio
Stringa
1.0
SI
Stringa
ORG-ENTE-1
SI
Tipo
predefinito
NOTIER
SI
Numerico
2014
SI
Inizio Sezione <InvioDocumento> [1..1]
Versione
Versione dell'XML del servizio di
invio documento
10 caratteri max
Inizio sezione <InvioDocumento>/<Documento> [1..1]
Inizio sezione <InvioDocumento>/<Documento>/<Chiave> [1..1]
Mittente
TipoMittente
Anno
4
Codice identificativo del
mittente del documento
Definisce la tipologia di
codice presente nel campo
“Mittente”
Anno del documento
50 caratteri max
Valori ammessi:
NOTIER
4 caratteri
Il nome del file può essere qualunque
NotiER – Specifiche tecniche servizi
11/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
FATTURA/NDC
Tipo dato
Esempio
Obbligat
orio
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 2:
3000000000001
- Numero Progressivo
50 caratteri max
ORDINE/DDT
Numero del documento che
identifica univocamente
l’ordine / documento di
trasporto
Tipologia di documento
Valori ammessi:
- FATTURA
Tipo
predefinito
FATTURA
SI
- NOTA_DI_CREDITO
TipoDocumento
- ORDINE
- DOCUMENTO_DI_TRASPORTO
- 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.
NotiER – Specifiche tecniche servizi
12/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligat
orio
Fine sezione <InvioDocumento>/<Documento>
Inizio sezione <InvioDocumento>/<Configurazione> [1..1]
InvioSdi6
Indica se il documento è da
inoltrare a SDI
Se posto a true allora il tag
InvioPeppol deve valere false
Booleano
true
SI
Indica se il documento è da
inoltrare ad un altro Access
Point su rete Busdox-Peppol
Se posto a true allora il tag
InvioSdi deve valere false
Booleano
false
SI
InvioPeppol
Indica se il documento è da
archiviare in conservazione
Se InvioSdi e InvioPeppol sono
entrambi a false allora deve
valere true
Booleano
true
SI
Indica se il documento, una
volta trasformato e firmato, è
da considerarsi
automaticamente 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
Documento
FATTURA o
NOTA DI
CREDITO
InvioConservazione
ApprovazioneAutomatica
6
AccettaChiaveDuplicata7
Fine sezione <InvioDocumento>/<Configurazione>
8
Inizio sezione <InvioDocumento>/<Integrazione> [0..1]
Registro
6
Identificativo del Registro o del
Tipo di Registro della Fattura o
della Nota di Credito.
100 caratteri max9
Stringa
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 “_”, “-”, “.”
NotiER – Specifiche tecniche servizi
13/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligat
orio
Fine sezione <InvioDocumento>/< Integrazione >
10
Inizio sezione <InvioDocumento>/<Collegamento > [0..1]
Urn
Urn NoTIER del Documento da
Collegare
256 caratteri max
Stringa
Si
Inizio sezione <InvioDocumento>/<Collegamento> [0..1]
11
Inizio sezione <InvioDocumento>/<MetadatiBusdox > [0..1]
RecipientIdentifier
SenderIdentifier
DocumentIdentifier
ProcessIdentifier
Identificativo busdox del
destinatario del documento
Identificativo busdox del mittente
del documento
Identificativo busdox del tipo di
documento
Identificativo busdox del processo
in cui il documento è utilizzato
256 caratteri max
256 caratteri max
1024 caratteri max
1024 caratteri max
Stringa
Stringa
Stringa
Stringa
12
13
14
14
SI se la
sezione
MetadatiBu
sdox è
presente
SI se la
sezione
MetadatiBu
sdox è
presente
SI se la
sezione
MetadatiBu
sdox è
presente
SI se la
sezione
MetadatiBu
sdox è
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
NotiER – Specifiche tecniche servizi
14/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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.
4.4.1 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>:<TipoDocumento>
L’attributo TipoCiclo può assumere valori
-
CA per il Ciclo Attivo
-
CP per il Ciclo Passivo
4.4.1.1 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>:<TipoDocumento>:<NumeroVersione>
La versione “01” corrisponde al primo invio del Documento e si incrementa ad ogni successivo
invio15, consentendo così di reinviare un Ordine o un DDT con gli stessi metadati. 16
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.
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.
NotiER – Specifiche tecniche servizi
15/55
NOTIER_AT_SpecificheServizi_v1.15_finale
4.4.2 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
Obbliga
torio
Stringa
1.0
SI
Inizio Sezione <EsitoRichiesta> [1..1]
Versione
Versione dell'XML di esito
risposta
10 caratteri max
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
DataRicezioneNotier
Identificatore del documento in 1024 caratteri max
NoTIER
Data e ora assegnata da NoTIER
al momento del ricevimento del
documento
Stringa
urn:notier:I
ORG001:2015:2
_85:CA:FAT
TURA
Data
SI
SI
Inizio sezione <EsitoRichiesta>/<Documento>/<Chiave> [1..1]
Mittente
TipoMittente
17
Codice identificativo del
mittente del documento
50 caratteri max
Stringa
Definisce la tipologia di
codice presente nel campo
Valori ammessi:
Tipo
predefinito
NOTIER
ORG-001
SI
SI
Per il significato e la descrizione dei codici d'errore si veda il Paragrafo 4.4.3
NotiER – Specifiche tecniche servizi
16/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbliga
torio
Numerico
2014
SI
“Mittente”
Anno
Anno del documento
4 caratteri
Numero
Numero del documento
50 caratteri max
Stringa
1/8
SI
TipoDocumento
Tipologia di documento
Valori ammessi:
Tipo
predefinito
FATTURA
SI
Tipo
predefinito
UBL
SI
Stringa
1.0
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
Formato del documento
Valori ammessi:
- UBL
- SDI
Versione
Versione del formato del
documento
10 caratteri max
Fine sezione <EsitoRichiesta>/<Documento>/<Rappresentazione>
Fine sezione <EsitoRichiesta>/<Documento>
Fine sezione <EsitoRichiesta>
4.4.3 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. 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
<EsitoRichiesta>/<Esito><DescrizioneErrore>
NotiER – Specifiche tecniche servizi
comunque
riportati
nel
tag
17/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Codice
Descrizione
ERR-000-INVIODOC-RICHIESTANON-VALIDA
Indica che la richiesta non è valida. La causa dell’ errore verrà dettagliata nel tag
<EsitoRichiesta>/<Esito><DescrizioneErrore> e dipende generalmente dalla
mancanza del file di Metadati e/o del Documento all’atto dell’ invio.
ERR-001-INVIODOC-XML-NONVALIDO
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 del tag <InvioDocumento>/<Versione> diverso
rispetto alla 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>,
<InvioDocumento>/<Configurazione>/<InvioPeppol> e
<InvioDocumento>/<Configurazione>/<InvioConservazione> tutti
valorizzati a false

l’XML valorizza i tag <InvioDocumento>/<Configurazione>/<InvioPeppol>
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
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>/<TipoDocumento>
ERR-INVIODOC-003-ORG-NONVALIDA
Indica che l'organizzazione, dichiarata all'interno dei tag
<InvioDocumento>/<Documento>/<Chiave>/<Mittente> e
<InvioDocumento>/<Documento>/<Chiave>/<TipoMittente>, non è presente nel
sistema
ERR-INVIODOC-004-TIPODOCNON-VALIDO
Indica
che
il
tipo
documento,
dichiarato
all'interno
del
tag
<InvioDocumento>/<Documento>/<Chiave>/<TipoDocumento>, non è presente
nel sistema
ERR-INVIODOC-005-FORMATORAPPR-NON-VALIDO
Indica che il formato di rappresentazione, dichiarato all'interno del tag
<InvioDocumento>/<Documento>/<Rappresentazione>/<Formato>, non è
presente nel sistema
NotiER – Specifiche tecniche servizi
18/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Codice
Descrizione
ERR-INVIODOC-006-VERSIONERAPPR-NON-VALIDA
Indica che la versione di rappresentazione, dichiarata all'interno del tag
<InvioDocumento>/<Documento>/<Rappresentazione>/<Versione>, non è
presente nel sistema
ERR-INVIODOC-007-DOC-NONVALIDO-XSD
Indica che il documento inviato non è valido rispetto l'XSD a cui è associato
ERR-INVIODOC-008-DOC-NONVALIDO-SCHEMATRON
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:
1. Il file xml relativo al Documento è già stato inviato in precedenza a
18
NoTIER.
2. Il valore del flag AccettaChiaveDuplicata è impostato a false.
3. Il Documento non è in uno stato compatibile con la sovrascrittura19
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>:<porta-NoTIER>/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.
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.
NotiER – Specifiche tecniche servizi
19/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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 chiamante aventi la
NO
tipologia specificata
Esempio:
/notier/rest/v1.0/documenti/recupero/?tipodoc=fattura
stato_giacenza
Restituisce la lista di tutti i documenti destinati al chiamante con lo stato
NO
giacenza specificato
Esempio: /notier/rest/v1.0/documenti/recupero/?stato_giacenza=da_recapitare
stato_conservazione
Restituisce la lista di tutti i documenti destinati al chiamante con lo stato
NO
di conservazione specificato
Esempio: /notier/rest/v1.0/documenti/recupero/?stato_conservazione=da_recapitare
data_inizio
Parametro utilizzato per abilitare il filtraggio per data di ricezione Notier
NO
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 ricezione Notier
NO
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 di doumenti,
indica l’indice da cui iniziare la paginazione.
20
SI
21
20
Per convenzione l’indice del primo documento è 0
NotiER – Specifiche tecniche servizi
20/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Filtro
Descrizione
Obbl
Esempio: /notier/rest/v1.0/documenti/recupero/?inizio=1&offset=100
offset
Parametro utilizzato per abilitare la paginazione della lista di documenti,
SI
22
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
5.2.1 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
Esempio
Obbligatorio
Stringa
1.0
SI
Inizio Sezione <EsitoRichiesta> [1..1]
Versione
Versione dell'XML di esito
risposta
10 caratteri max
Inizio sezione <EsitoRichiesta>/<Esito> [1..1]
CodiceEsito
Esito della richiesta. Vale OK
Valori ammessi:
Tipo
21
Solo se è stato specificato il parametro offset
22
Solo se è stato specificato il parametro inizio
23
L’ordinamento per data Ricezione si applica anche in caso vengano applicati i filtri previsti dal Servizio.
NotiER – Specifiche tecniche servizi
SI
21/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
in caso di esito positivo, KO in
caso di esito negativo
- OK
Tipo dato
Esempio
Obbligatorio
predefinito
- KO
CodiceErrore
Definisce il codice dell'errore24 Presente se CodiceEsito=KO
DescrizioneErrore
Descrizione dell'errore
Presente se CodiceEsito=KO
Tipo
predefinito
NO
Stringa
NO
Fine sezione <EsitoRichiesta>/<Esito>
Inizio sezione <EsitoRichiesta>/<ListaDocumenti> [1..1]
NumeroDocumenti
Numero di documenti
presenti nella lista. Determina
il numero di tag
<EsitoRichiesta>/<ListaDocu
menti>/<Documenti>/<Docu
mento> presenti nella
risposta
5
Numero
SI
25
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti> [0..1]
26
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento> [1..N]
Destinatario
Codice NoTIER identificativo
del destinatario del
documento
50 caratteri max
Stringa
Urn
Identificatore del documento
in NoTIER
1024 caratteri max
Stringa
DataRicezioneNotier
Data e ora assegnata da
NoTIER al momento del
ricevimento del documento27
UrnCollegato
Identificatore del documento
collegato.
ORG-001
SI
urn:notie
r:IORG001:201
4:2_85:F
ATTURA
SI
Data
1024 caratteri max
Stringa
Ad esempio nel caso di una
notifica è la fattura a cui si
riferisce
24
Per il significato e la descrizione dei codici d'errore si veda il Paragrafo 5.2.2
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
SI
urn:notie
r:IORG001:201
4:2_85:F
ATTURA
NO
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.
NotiER – Specifiche tecniche servizi
22/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
StatoGiacenza
Descrizione
Vincoli
Stato in cui si trova la sessione Valori ammessi:
di ricezione del documento
DA_RECAPITARE
Tipo dato
Esempio
Obbligatorio
Tipo
predefinito
NO
Tipo
predefinito
NO
RECAPITATO
IN_LAVORAZIONE
StatoConservazione
Stato in cui si trova la sessione Valori ammessi:
di invio in conservazione
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
TipoMittente
50 caratteri max
Stringa
SOGG-001
SI
Definisce la tipologia di codice Valori ammessi:
presente nel campo
NOTIER
“Mittente”
Tipo
predefinito
NOTIER
SI
Anno
Anno del documento
4 caratteri
Numerico
2014
SI
Numero
Numero del documento
50 caratteri max
Stringa
1/8
SI
TipoDocumento
Tipologia di documento
Valori ammessi:
Tipo
predefinito
FATTURA
SI
FATTURA
NOTA_DI_CREDITO
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_COMMITTENTE
NOTIFICA_DI_DECORRENZA_TERMINI
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.
NotiER – Specifiche tecniche servizi
23/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligatorio
ATTESTAZIONE_DI_FILE_NON_RECAPITABILE
NOTIFICA_METADATI_FILE_FATTURA
ESITO_CONSERVAZIONE29
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Chiave>
Inizio sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Rappresentazione> [1..1]
Formato
Formato del documento
Valori ammessi:
- UBL
Tipo
predefinito
UBL
SI
Stringa
1.0
SI
- SDI
- PARER
Versione
Versione del formato del
documento
10 caratteri max
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>/<Rappresentazione>
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>/<Documento>
Fine sezione <EsitoRichiesta>/<ListaDocumenti>/<Documenti>
Fine sezione <EsitoRichiesta>/<ListaDocumenti>
Inizio sezione <EsitoRichiesta>
5.2.2 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. 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
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
NotiER – Specifiche tecniche servizi
24/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Codice
Descrizione
<EsitoRichiesta>/<Esito><DescrizioneErrore>
ERR-RECDOC-000-RICHIESTANON-VALIDA
Indica che la richiesta non è valida. La causa dell’ errore verrà dettagliata nel tag
<EsitoRichiesta>/<Esito><DescrizioneErrore> 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
Indica che il chiamante, identificato tramite il Common Name del 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.
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
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.
NotiER – Specifiche tecniche servizi
25/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Formato dell'XML di risposta
6.3.1
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.
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbliga
torio
Stringa
1.0
SI
Inizio Sezione <EsitoRichiesta> [1..1]
Versione
Versione dell'XML di esito
risposta
10 caratteri max
Inizio sezione <EsitoRichiesta>/<Esito> [1..1]
CodiceEsito
Esito della richiesta
Valori ammessi:
- KO
CodiceErrore
Definisce il codice dell'errore30
DescrizioneErrore
Descrizione dell'errore
Tipo
predefinito
SI
Tipo
predefinito
SI
Stringa
SI
Fine sezione <EsitoRichiesta>/<Esito>
Fine sezione <EsitoRichiesta>
6.3.2
Codici di errore
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. 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
<EsitoRichiesta>/<Esito><DescrizioneErrore>
comunque
riportati
nel
tag
ERR-RECDOC-001-NONAUTORIZZATO
Indica che il chiamante, identificato tramite il Common Name del 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.
30
Per il significato e la descrizione dei codici d'errore si veda il Paragrafo 5.2.2
NotiER – Specifiche tecniche servizi
26/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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 l’Invio del Documento in Conservazione
(PARER). Attualmente il servizio supporta solamente l’Integrazione da parte del chiamante delle
fatture di ciclo passivo31, 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>:<porta-NoTIER>/notier/rest/v1.0/documenti/daticonservazione
7.2 Richiesta
La request deve essere una POST HTTP all’indirizzo specificato nel Paragrafo Errore. L'origine
riferimento non è stata trovata. e deve:
 Specificare un Request Header Content-Type di tipo “multipart/form-data”
 Specificare un Payload identificato da un Payload Header Content-Disposition “form-data”
come segue:
o Attributo name=“metadati” per l’XML con i Metadati
o Attributo filename valorizzato32
 Come descritto nel Paragrafo 2.3, il Payload dovrà inoltre avere un Payload Header
Content-Type: application/xml; charset=UTF-8
31
NoTIER è in grado di integrare autonomamente le Fatture di ciclo attivo da inviare in Conservazione
32
Il nome del file può essere qualunque
NotiER – Specifiche tecniche servizi
27/55
NOTIER_AT_SpecificheServizi_v1.15_finale
7.2.1 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.
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligat
orio
Stringa
1.0
SI
urn:notier:OR
G001:2014:2_8
5:CA:FATTURA
SI
4534
SI
Inizio Sezione < DatiConservazione> [1..1]
Versione
Versione dell'XML del servizio di
invio documento
10 caratteri max
Inizio sezione < DatiConservazione>/< Documento > [1..1]
Urn
Identificatore del documento
presente in NoTIER
1024 caratteri max
Stringa
Fine sezione < DatiConservazione>/< Documento >
Inizio sezione < DatiConservazione>/< DatiRegistrazione > [1..1]
NumeroRegistrazione
DataRegistrazione
Registro
OggettoFornitura
Scadenza
RiferimentoContabile
Numero di registrazione del
Documento assegnato dal
Destinatario33
50 caratteri max
Data di registrazione del
Documento assegnato dal
Destinatario
Tipo
predefinito
Data
SI
Identificativo del Registro in cui il 50 caratteri max
Documento viene registrato dal
Destinatario
Tipo
predefinito
RG_001
SI
Oggetto della Fornitura a cui si
33
riferisce il Documento
Tipo
predefinito
FORN_INTERC
ENTER
NO
50 caratteri max
Data di scadenza del
33
Documento
Nel caso di contabilità finanziaria, 50 caratteri max
indica gli estremi dell’ impegno
indicato in Fattura o documento
33
contabile equivalente
Data
Tipo
predefinito
NO
IMP_456
NO
33
Previsto Ex. Articolo 42. Si noti che la normativa è ancora in fase di Approvazione, pertanto i campi e la relativa
obbligatorietà potrebbero cambiare
NotiER – Specifiche tecniche servizi
28/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
TipoRifContabile
Descrizione
33
Tipo di Riferimento Contabile
Vincoli
Valori ammessi:
Tipo dato
Esempio
Obbligat
orio
Tipo
predefinito
NO
Indica se la spesa a cui si riferisce Valori ammessi:
il Documento (Fattura Passiva) è
- SI
33
rilevate ai fini IVA
- NO
Tipo
predefinito
NO
CIG
Indica il Codice Identificativo di
33
Gara
50 caratteri max
Tipo
predefinito
GARA_345
NO
CUP
Indica il Codice Unico di
33
Progetto
50 caratteri max
Tipo
predefinito
PROG_345
NO
- IMPEGNO
- CAPITOLO
- PIANO_GESTIONALE
RilevanzaIVA
DatiSpecifici
Ulteriori Metadati Specifici34
Any
NO
Inizio sezione < DatiIntegrazione >/< DatiRegistrazione >/<Protocollo> [1..1]
NumeroProtocollo
Numero nel registro di Protocollo
assegnato dal Destinatario
DataProtocollo
Data di riferimento del numero di
protocollo assegnato dal
Destinatario
50 caratteri max
Tipo
predefinito
PROT_53
Data
SI
SI
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<Protocollo>
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati> [0..1]
35
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>/< DocumentoCollegato> [1..n]
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>/< DocumentoCollegato>/<
ChiaveCollegamento > [1..1]
Numero
Anno
Numero di Registro del
Documento Collegato
100 caratteri max
Tipo
predefinito
Anno di registrazione
4 caratteri
Numerico
100 caratteri max
Tipo
predefinito
TipoRegistro
NUM_7896
SI
SI
REG_ACQUISTI
SI
34
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.
35
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.
NotiER – Specifiche tecniche servizi
29/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligat
orio
Fine sezione < DatiConservazione >/< DatiRegistrazione >/<DocumentiCollegati>/< DocumentoCollegato>/<
ChiaveCollegamento >
DescrizioneCollegamento
Descrizione del Documento
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
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoloPrincipale > / <
Fascicolo > [0..1]
Identificativo
Identificativo del Fascicolo
Principale
100 caratteri max
Tipo
predefinito
SI
Oggetto del Fascicolo Principale
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
Oggetto
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoloPrincipale > / <
Fascicolo >
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoloPrincipale > /
<SottoFascicolo > [0..1]
Identificativo
Identificativo del SottoFascicolo
100 caratteri max
Tipo
predefinito
SI
Oggetto del SottoFascicolo
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
Oggetto
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoloPrincipale > /
<SottoFascicolo >
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoloPrincipale>
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> [0..1]
NotiER – Specifiche tecniche servizi
30/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbligat
orio
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> / <
FascicoloSecondario> [1..n]
Classifica
Classificazione del Fascicolo
Secondario
256 caratteri max
Tipo
predefinito
NO
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> / > / <
FascicoloSecondario> / < Fascicolo > [0..1]
Identificativo
Identificativo del Fascicolo
Secondario
100 caratteri max
Tipo
predefinito
SI
Oggetto del Fascicolo secondario
1024 caratteri max
Tipo
predefinito
SI (puo’
avere un
valore
nullo)
Oggetto
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> / <
FascicoloSecondario> / < Fascicolo >
Inizio sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< 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)
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> / <
FascicoloSecondario> / <SottoFascicolo >
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari> / <
FascicoloSecondario>
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>/< FascicoliSecondari>
Fine sezione < DatiConservazione >/< DatiRegistrazione >/< ProfiloArchivistico>
Fine sezione < DatiConservazione >/< DatiRegistrazione >
Fine sezione < DatiConservazione >
NotiER – Specifiche tecniche servizi
31/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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.
7.3.1 Formato del file XML di risposta
Tag XML
Descrizione
Vincoli
Tipo dato
Esempio
Obbliga
torio
Stringa
1.0
SI
Inizio Sezione <EsitoRichiesta> [1..1]
Versione
Versione dell'XML di esito
risposta
10 caratteri max
Inizio sezione <EsitoRichiesta>/<Esito> [1..1]
CodiceEsito
Esito della richiesta. Vale OK in
caso di esito positivo, KO in caso
di esito negativo
Valori ammessi:
- OK
Tipo
predefinito
SI
- KO
CodiceErrore
Definisce il codice dell'errore 36
Presente se CodiceEsito=KO
Tipo
predefinito
NO
DescrizioneErrore
Descrizione dell'errore
Presente se CodiceEsito=KO
Stringa
NO
Fine sezione <EsitoRichiesta>/<Esito>
7.3.2 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
Descrizione
ERR-000-GENERICO
Codice d'errore generico. Indica che NoTIER non è riuscito ad elaborare la richiesta
a causa di un errore generico interno. 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.
ERR-CONSDOC-000-RICHIESTA-
Indica che la richiesta non è valida. La causa dell'errore, dettagliata nel tag
36
Per il significato e la descrizione dei codici d'errore si veda il Paragrafo 7.3.2
NotiER – Specifiche tecniche servizi
32/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Codice
Descrizione
NON-VALIDA
descrizioneErrore, è la mancanza dell'XML dei metadati.
ERR-CONSDOC-001-XML-NONVALIDO
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
Indica che il chiamante, identificato tramite il Common Name del 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 <DatiConservazione
ERR-CONSDOC-004-NONAPPLICABILE
Indica che per il tipo di Documento specificato dal tag <DatiConservazione
37
>/<Documento>/< Urn > non è applicabile il servizio di Integrazione
>/<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.
In entrambi i casi il versamento è effettuato componendo autonomamente i metadati 38 di
conservazione a partire dai dati contenuti nell’XML del documento.
37
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)
38
Tali metadati sono ancora in corso di definizione.
NotiER – Specifiche tecniche servizi
33/55
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>
NOTIER_AT_SpecificheServizi_v1.15_finale
<Numero>1/80</Numero>
<TipoDocumento>FATTURA</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>UBL</Formato>
<Versione>2.1</Versione>
</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>
NotiER – Specifiche tecniche servizi
35/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.1.2 File XML “metadati”
<?xml version="1.0" encoding="utf-8"?>
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request">
<Versione>1.0</Versione>
<Documento>
<Chiave>
<Mittente>org0002</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2014</Anno>
<Numero>456/14</Numero>
<TipoDocumento>FATTURA</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>SDI</Formato>
<Versione>1.1</Versione>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>true</InvioSdi>
<InvioPeppol>false</InvioPeppol>
<InvioConservazione>true</InvioConservazione>
<ApprovazioneAutomatica>true</ApprovazioneAutomatica>
<AccettaChiaveDuplicata>false</AccettaChiaveDuplicata>
</Configurazione>
<Integrazione>
<Registro>Reg.Acq</Registro>
</Integrazione>
</InvioDocumento>
NotiER – Specifiche tecniche servizi
36/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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
<?xml version="1.0" encoding="utf-8"?>
<EsitoRichiesta xmlns=" http://notier.intercenter.rer.it/services/1.0/esito/response"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<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>
<Mittente>org002</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2014</Anno>
<Numero>456/14</Numero>
<TipoDocumento>FATTURA</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>SDI</Formato>
<Versione>1.1</Versione>
</Rappresentazione>
NotiER – Specifiche tecniche servizi
37/55
NOTIER_AT_SpecificheServizi_v1.15_finale
</Documento>
</EsitoRichiesta>
A.2 Invio Documento di tipo Fattura PEPPOL con Esito Negativo
A.2.1 File xml “metadati”
<?xml version="1.0" encoding="utf-8"?>
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<Documento>
<Chiave>
<Mittente>org0010</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2014</Anno>
<Numero>134/14</Numero>
<TipoDocumento>FATTURA</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>UBL</Formato>
<Versione>2.1</Versione>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>false</InvioSdi>
NotiER – Specifiche tecniche servizi
38/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<InvioPeppol>true</InvioPeppol>
<InvioConservazione>false</InvioConservazione>
<ApprovazioneAutomatica>false</ApprovazioneAutomatica>
<AccettaChiaveDuplicata>false</AccettaChiaveDuplicata>
</Configurazione>
<Integrazione>
<Registro>Reg.Acq</Registro>
</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 >
NotiER – Specifiche tecniche servizi
39/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.2.3 File xml di Esito Risposta
<?xml version="1.0" encoding="utf-8"?>
<EsitoRichiesta xmlns=" http://notier.intercenter.rer.it/services/1.0/esito/response"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<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”
<?xml version="1.0" encoding="utf-8"?>
<InvioDocumento xmlns="http://notier.intercenter.rer.it/services/1.0/inviodocumento/request"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<Documento>
<Chiave>
<Mittente>org0002</Mittente>
<TipoMittente>NOTIER</TipoMittente>
NotiER – Specifiche tecniche servizi
40/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<Anno>2015</Anno>
<Numero>005</Numero>
<TipoDocumento>DOCUMENTO_DI_TRASPORTO</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>UBL</Formato>
<Versione>2.1</Versione>
</Rappresentazione>
</Documento>
<Configurazione>
<InvioSdi>false</InvioSdi>
<InvioPeppol>true</InvioPeppol>
<InvioConservazione>true</InvioConservazione>
<ApprovazioneAutomatica>false</ApprovazioneAutomatica>
<AccettaChiaveDuplicata>false</AccettaChiaveDuplicata>
</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</DocumentIdentifier>
<ProcessIdentifier> urn:www.cenbii.eu:profile:bii03:ver2.0</ProcessIdentifier>
</MetadatiBusdox>
</InvioDocumento>
NotiER – Specifiche tecniche servizi
41/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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>
A.2.3 File xml di Esito Risposta
<?xml version="1.0" encoding="utf-8"?>
<EsitoRichiesta xmlns=" http://notier.intercenter.rer.it/services/1.0/esito/response"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<Esito>
<CodiceEsito>OK</CodiceEsito>
</Esito>
<Documento>
<Urn>urn:notier:org0002:2015:005:CA:DOCUMENTO_DI_TRASPORTO:01</Urn>
<DataRicezioneNotier>2015-01-01 00:00:00</DataRicezioneNotier>
<Chiave>
<Mittente>org0002</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2015</Anno>
<Numero>005</Numero>
<TipoDocumento> DOCUMENTO_DI_TRASPORTO</TipoDocumento>
</Chiave>
<Rappresentazione>
NotiER – Specifiche tecniche servizi
42/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<Formato>UBL</Formato>
<Versione>2.1</Versione>
</Rappresentazione>
</Documento>
</EsitoRichiesta>
A.4 Recupero Notifiche di Esito in Stato “Da recapitare” per un destinatario specificato
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
A.4.2 File xml di Esito Risposta
<?xml version="1.0" encoding="utf-8"?>
<EsitoRichiesta xmlns=" http://notier.intercenter.rer.it/services/1.0/esito/response"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<Esito>
<CodiceEsito>OK</CodiceEsito>
</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>
NotiER – Specifiche tecniche servizi
43/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<UrnCollegato>urn:notier:org001:2014:11_2013:CP:FATTURA</UrnCollegato>
<Chiave>
<Mittente>org-org020</Mittente>
<TipoMittente>NOTIER</TipoMittente>
<Anno>2014</Anno>
<Numero>567</Numero>
<TipoDocumento>NOTIFICA _DI_ESITO_COMMITTENTE</TipoDocumento>
</Chiave>
<Rappresentazione>
<Formato>SDI</Formato>
<Versione>1.1</Versione>
</Rappresentazione>
</Documento>
</Documenti>
</ListaDocumenti>
</EsitoRichiesta>
A.5 Recupero Documento con Esito Negativo
A.5.1 Query String di Invocazione del Servizio
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/urn:notier:org020:2014:568:CP:NOTIFICA_DI_ESITO_COMMITTENTE
A.5.2 File xml di Esito Risposta
<?xml version="1.0" encoding="utf-8"?>
<EsitoRichiesta xmlns="http://notier.intercenter.rer.it/services/1.0/esito/response "
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
NotiER – Specifiche tecniche servizi
44/55
NOTIER_AT_SpecificheServizi_v1.15_finale
xsi:schemaLocation="http://notier.intercenter.rer.it/services/response ">
<Versione>1.0</Versione>
<Esito>
<CodiceEsito>KO</CodiceEsito>
<CodiceErrore>ERR-RECDOC-000-NON-TROVATO</CodiceErrore>
<DescrizioneErrore>Documento urn:notier:org020:2014:568:CP:NOTIFICA_DI_ESITO_COMMITTENTE non trovato</DescrizioneErrore>
</Esito>
</EsitoRichiesta>
NotiER – Specifiche tecniche servizi
45/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.6 Recupero di Notifica MDN con Esito Positivo
A.6.1 Query String di Invocazione del Servizio
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
<?xml version="1.0" encoding="utf-8"?>
<NotificaMDN xmlns="http://notier.intercenter.rer.it/services/1.0/notificaMDN"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://notier.intercenter.rer.it/services/1.0/notificaMDN">
<Versione>1.0</Versione>
<Esito>
<Documento>
<Urn>urn:notier:org0002:2015:005:CA:DOCUMENTO_DI_TRASPORTO:01</Urn>
<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::2.1</DocumentID>
</Documento>
<CodiceEsito>OK</CodiceEsito>
<EsitoMDN>
<MessageID>490c31d4-49a7-471b-93de-bf95f843515b</MessageID>
<TransmissionID>d0a68c6f-0e00-49d3-a380-37b94d73890c</TransmissionID>
</EsitoMDN>
</Esito>
</ NotificaMDN >
NotiER – Specifiche tecniche servizi
46/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.7 Integrazione Dati Fiscali con esito positivo
A.7.1 File XML “metadati”
<?xml version="1.0" encoding="utf-8"?>
<DatiIntegrazione xmlns=" http://notier.intercenter.rer.it/services/1.0/daticonservazione/request"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Versione>1.0</Versione>
<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>
NotiER – Specifiche tecniche servizi
47/55
NOTIER_AT_SpecificheServizi_v1.15_finale
A.7 Recupero di Esito Versamento con Esito Positivo
A.7.1 Query String di Invocazione del Servizio
https://<host-NoTIER>:<porta-NoTIER>/notier/rest/v1.0/documenti/recupero/ urn:notier:org0002:2015:005:CA: ESITO_CONSERVAZIONE
A.7.2 File XML di Esito Risposta
<?xml version="1.0" encoding="UTF-8"?>
<EsitoVersamento>
<Versione>1.4</Versione>
<VersioneXMLChiamata>1.4</VersioneXMLChiamata>
<DataVersamento>2015-10-09T13:36:01.166+02:00</DataVersamento>
<EsitoGenerale>
<CodiceEsito>POSITIVO</CodiceEsito>
<CodiceErrore/>
<MessaggioErrore/>
</EsitoGenerale>
<EsitoChiamataWS>
<VersioneWSCorretta>POSITIVO</VersioneWSCorretta>
<CredenzialiOperatore>POSITIVO</CredenzialiOperatore>
<FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti>
</EsitoChiamataWS>
<EsitoXSD>
<CodiceEsito>POSITIVO</CodiceEsito>
<ControlloStrutturaXML>POSITIVO</ControlloStrutturaXML>
<UnivocitaIDComponenti>POSITIVO</UnivocitaIDComponenti>
<UnivocitaIDDocumenti>POSITIVO</UnivocitaIDDocumenti>
<CorrispondenzaAllegatiDichiarati>POSITIVO</CorrispondenzaAllegatiDichiarati>
NotiER – Specifiche tecniche servizi
48/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<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>
NotiER – Specifiche tecniche servizi
49/55
NOTIER_AT_SpecificheServizi_v1.15_finale
</Versatore>
<Chiave>
<Numero>4/13</Numero>
<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>
<CodiceEsito>POSITIVO</CodiceEsito>
<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>
<TipoDocumento>FATTURA</TipoDocumento>
<FirmatoDigitalmente>true</FirmatoDigitalmente>
<EsitoDocumento>
<CodiceEsito>POSITIVO</CodiceEsito>
<VerificaTipoDocumento>POSITIVO</VerificaTipoDocumento>
<CorrispondenzaDatiSpecifici>POSITIVO</CorrispondenzaDatiSpecifici>
<CorrispondenzaDatiFiscali>POSITIVO</CorrispondenzaDatiFiscali>
<VerificaTipoStruttura>POSITIVO</VerificaTipoStruttura>
<VerificaFirmeDocumento>POSITIVO</VerificaFirmeDocumento>
<UnivocitaOrdinePresentazione>POSITIVO</UnivocitaOrdinePresentazione>
</EsitoDocumento>
<Componenti>
NotiER – Specifiche tecniche servizi
50/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<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>
<FirmatoDigitalmente>true</FirmatoDigitalmente>
<EsitoComponente>
<CodiceEsito>POSITIVO</CodiceEsito>
<VerificaTipoComponente>POSITIVO</VerificaTipoComponente>
<CorrispondenzaDatiSpecifici>POSITIVO</CorrispondenzaDatiSpecifici>
<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-10-09T07:16:43.000+02:00</RiferimentoTemporaleUsato>
<TipoRiferimentoTemporaleUsato>DATA_FIRMA</TipoRiferimentoTemporaleUsato>
<EsitoFirma>
<ControlloConformita>POSITIVO</ControlloConformita>
NotiER – Specifiche tecniche servizi
51/55
NOTIER_AT_SpecificheServizi_v1.15_finale
<DettaglioControlloConformita>Formato riconosciuto e conforme</DettaglioControlloConformita>
<VerificaFirma>
<CodiceEsito>POSITIVO</CodiceEsito>
<ControlloCrittografico>POSITIVO</ControlloCrittografico>
<DettaglioControlloCrittografico>Controllo OK</DettaglioControlloCrittografico>
<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>
<CodiceEsito>POSITIVO</CodiceEsito>
<VerificaTipoComponente>POSITIVO</VerificaTipoComponente>
<CorrispondenzaDatiSpecifici>POSITIVO</CorrispondenzaDatiSpecifici>
<VerificaTipoSupportoComponente>POSITIVO</VerificaTipoSupportoComponente>
</EsitoSottoComponente>
</SottoComponente>
</SottoComponenti>
</Componente>
</Componenti>
</DocumentoPrincipale>
</UnitaDocumentaria>
</EsitoVersamento>
NotiER – Specifiche tecniche servizi
52/55
NOTIER_AT_SpecificheServizi_v1.15_finale
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
39
Il valore di CustomizationID è invece quello previsto dalle specifiche relative alla localizzazione Italiana dei Documenti PEPPOL, reperibile sul sito di IntercentER
40
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
Fattura
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
Credito
urn:www.cenbii.eu:profile:bii05: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.ublitalia.org:spec:fatturapa:ver2.0::2.1
39
40
DOCUMENT ID
Attualmente reperibili su https://joinup.ec.europa.eu/svn/peppol/TransportInfrastructure/PEPPOL_Policy%20for%20use%20of%20identifiers-300.pdf
Attualmente reperibili su http://intercenter.regione.emilia-romagna.it/aree/dematerializzazione-acquisti/infografica-p-a/p-a/dematerializzazione-degli-acquisti-sezione-p-a
NotiER – Specifiche tecniche servizi
53/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Ordine
urn:www.cenbii.eu:profile:bii03:ver2.0
urn:oasis:names:specification:ubl:schema:xsd:Order-2::Order##urn:www.cenbii.eu:transaction:biitrns001:ver2.0:extended:urn:www.peppol.eu:bis:peppol3a:ver2.0::2.1
DDT
urn:www.cenbii.eu:profile:bii03: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::2.1
Esempio di Metadati PEPPOL per l’ invio di una Fattura
NotiER – Specifiche tecniche servizi
54/55
NOTIER_AT_SpecificheServizi_v1.15_finale
Esempio di Metadati PEPPOL per l’ invio di un Documento di Trasporto
NotiER – Specifiche tecniche servizi
55/55