PIATTAFORMA PER LA CERTIFICAZIONE DEI CREDITI SPECIFICA INTERFACCIA WS FATTURE - IMPRESE

Transcript

1 PIATTAFORMA PER LA CERTIFICAZIONE DEI CREDITI SPECIFICA INTERFACCIA WS FATTURE - IMPRESE Versine 1.0 del 29/02/2016

2 Smmari PARTE I INTRODUZIONE Glssari Generalità del servizi Prtcll di cllqui e fluss prcedurale Specifica della Sicurezza Mdalità di ergazine del servizi Mdell di funzinament Descrizine del prcess Access al servizi Riferimenti Infrastrutturali PARTE II-DESCRIZIONE DEI SERVIZI WS-PROXY Dati Fatture Struttura del servizi WS-Prxy Dati Fatture Cntrlli sui dati Cntrlli di presa in caric Cntrlli di elabrazine dati WS-QUERY Dati Fatture Struttura del servizi WS-Query Dati Fatture Cntrlli sui dati Schema dati fatture WS-READ Stat Fattura Struttura del servizi WS-Read Stat Fattura Cntrlli sui dati WS-READ Interrgazine Esiti Struttura del servizi WS-Read Interrgazine Esiti Cntrlli sui dati Metd di test

3 8.1. Struttura del servizi TestWS Cdici Esit Elabrazine e Trasmissine Scheda web service Crnlgia delle revisini Versine /02/2016 Revisine integrale della grafica del dcument. Aggiunta la sezine 10 Mdificata sezine 8 (intrdtt metd testws) Mdificata sezine 6.1 (eliminat camp Identificativ transazine trasmittente dalla sezine di Testata richiesta, mdificat Elenc Transazine Trasmittente nella sezine Dati richiesta) Intrdtta sezine 5.3 Mdificate le sezine 5.1 (revisinata la sezine dei dati di input), 5.2 Mdificata sezine 5.1 (intrdtta descrizine sulle mdalità di dwnlad del file) Mdificata sezine 4.1 (revisinata la sezine relativa ai dati di input ed utput) Mdificata sezine 4.1 (eliminat camp File Allegat, inserit camp Lista URL) Mdificata sezine 3.2 (intrdtta descrizine sulle mdalità di trasmissine del certificat per la mutua autenticazine) Versine /07/2015 Prima emissine bzza 3

4 PARTE I INTRODUZIONE Il presente dcument descrive le specifiche di interfaccia per la realizzazine dei servizi web attravers cui sarà pssibile accedere alle funzini del sistema PCC già dispnibili n line (mdalità c.d. manuale). 1. Glssari Web Service. Insieme di servizi metdi sftware finalizzat alla interazine di sistemi sftware etergenei. URI (Unifrm Resurce Identifier). Sequenza di caratteri che identifica univcamente un qualsiasi indirizz web, un dcument, un'immagine, un file, un servizi, un indirizz di psta elettrnica, ecc. End-pint. Indirizz, in frmat URI, sul quale è dispnibile l access al servizi web. Intermediari. Sggett abilitat all utilizz dei WS messi a dispsizine dalla piattafrma PCC per cnt di una più amministrazini della PA. Fattura. Fattura dcument equivalente 1. Nel cas di fatture elettrniche 2, l identificazine della fattura avverrà utilizzand l identificativ assegnat dal sistema di interscambi. Stat di una fattura. Insieme di prprietà che definisce l stat cntabile attuale di una fattura (determinat dalle cntabilizzazini, dalle cmunicazini di scadenza, dai pagamenti, ecc.). Transazine. Insieme di una più perazini, che può cncludersi cn un success un insuccess; in cas di success, il risultat delle perazini deve essere permanente persistente, mentre in cas di insuccess si deve trnare all stat precedente all'inizi della transazine. Sistema client. Sistema infrmatic (tipicamente un sistema cntabile) dell Amministrazine Ente Pubblic che alimenta il sistema PCC 3. Operazine. Azine effettuata sul sistema PCC (es.: cntabilizzazine, pagament, strn pagament, ecc.), rilevante ai fini del mnitraggi svlt attravers il sistema PCC 4. 1 Il dcument equivalente è un dcument che, pur attestand un credit cmmerciale, nn è una fattura (es.: nte di addebit emesse da sggetti nn titlari di partita IVA) e nn sn trasmessi tramite il sistema di interscambi. più enti. 2 Le fatture elettrniche sn trasmesse tramite il sistema di interscambi. 3 Il sistema client può anche nn essere il sistema cntabile di un ente, bensì il sistema di un intermediari che pera per un 4

5 Servizi. Funzinalità del Web Service, che cnsente di effettuare una transazine sul sistema PCC. Esit. Rispsta del sistema PCC a seguit dell invcazine di un servizi di tip WS-Prxy. L esit di un servizi WS-Prxy può essere psitiv negativ. Risultat. Rispsta del sistema PCC a seguit dell invcazine di un servizi di tip WS-Query WS-Read. Un risultat cntiene infrmazini di business di servizi. SOAP. E l'acrnim di Simple Object Access Prtcl ed è un prtcll per l scambi di messaggi tra cmpnenti sftware (slitamente definiti client e web service) che avviene secnd le regle della sintassi XML. XML. (extensible Markup Language) è un metalinguaggi per la definizine di linguaggi di markup, vver un linguaggi marcatre basat su un meccanism sintattic che cnsente di definire e cntrllare il significat degli elementi cntenuti in un dcument in un test. WS-Prxy. Servizi tramite il quale un sistema client può richiedere, in mdalità asincrna, infrmazini gestite sul sistema PCC. L esecuzine di una elabrazine sul sistema PCC, richiesta tramite un servizi WS-Prxy, avviene sl in cas di esit psitiv. Ogni servizi WS-Prxy ha un crrispettiv servizi WS-Query. WS-Query. Servizi tramite il quale un sistema client può richiedere il risultat di una elabrazine eseguita sul sistema PCC a seguit di una invcazine di un servizi WS-Prxy avvenuta cn esit psitiv. Ogni servizi WS-Query ha un crrispettiv servizi WS-Prxy. WS-Read. Servizi tramite il quale un sistema client può cnsultare, in mdalità sincrna, infrmazini gestite in PCC. 4 Mnitraggi dei debiti cmmerciali delle pubbliche amministrazini, effettuat ai sensi del D.L. 35/2013, art. 7bis. 5

6 2. Generalità del servizi Il presente capitl descrive nel dettagli il servizi applicativ realizzat per cnsentire l access alle funzini del sistema PCC (Piattafrma per la Certificazine dei crediti della PA) già dispnibili n line. Sn di seguit definite e descritte semantica, sicurezza ed identità del servizi applicativ realizzat Prtcll di cllqui e fluss prcedurale Nell architettura tecnica utilizzata per la cperazine applicativa tra i Sistemi Infrmativi (S.I.) delle amministrazini, la sla ed esclusiva mdalità di interazine tra il sistema ergatre (S.I. MEF) ed i sistemi fruitri cnsiste nell scambi di messaggi sap strutturati sulla base degli standard tecnlgici definiti da AGID web service. L scambi dei suddetti messaggi è utilizzat per crdinare l ergazine/fruizine del servizi funzinale alla realizzazine dell interperabilità tra le amministrazini. Nel cas di specie, la medesima architettura sarà estesa anche all interazine cn le imprese; la fruizine del web service avverrà tramite scambi di tip messaggi/replica, sincrn. Il Minister dell Ecnmia e delle Finanze pubblicherà sul prpri End-pint un insieme di web service; le Imprese sggetti delegati che presenterann l adesine, in qualità di fruitri, interrgherann, tramite il prpri End-pint, i servizi specificati nella sezine Descrizine del prcess Specifica della Sicurezza Il servizi sarà ergat in sicurezza utilizzand il prtcll SSL v3 standard, che cnsente di effettuare una mutua autenticazine cifrand il traffic TCP/IP tra i due End-pint. Il prtcll SSL garantisce la riservatezza del cntenut dei messaggi, l integrità dei messaggi scambiati e la mutua autenticazine tra client e server, garantend l access al servizi alle sle entità in pssess dei certificati. 6

7 2.3. Mdalità di ergazine del servizi Il servizi sarà dispnibile h24 (24 re su 24). Eventuali interruzini sarann pprtunamente cmunicate attravers la pubblicazine di avvisi sul sit: Le Imprese fruitrici ptrann avvalersi del servizi di assistenza nell intervall temprale 08:00-18:00. Il crrett utilizz del servizi ne suggerisce una fruizine analga a quant già previst nline nell ambit della Piattafrma PCC. 7

8 3. Mdell di funzinament I WS espsti dal sistema PCC sarann ttalmente disaccppiati dalle perazini dei sistemi client. Ogni sistema client implementerà una più invcazini di WS in base alla prpria lgica di business Descrizine del prcess Il meccanism di funzinament può essere illustrat cn il seguente esempi. Richiesta elenc fatture Per cnsultare in PCC i dati relativi ad un elenc fatture, il sistema client avvia un cllqui cn PCC mediante l invcazine dei metdi rappresentati nel seguente diagramma: 8

9 Il sistema client trasmette a PCC una richiesta riferita ad un insieme di fatture attravers l invcazine del servizi WS-PROXY Dati Fatture. Il sistema PCC, alla ricezine della richiesta, avvia i cntrlli di presa in caric restituend in temp reale il messaggi di esit. In cas di esit psitiv la transazine viene aggiunta alla cda di elabrazine. Per cnscere l esit dell elabrazine del servizi, il sistema client deve interrgare la piattafrma PCC mediante il servizi WS-READ Interrgazine Esiti. 9

10 Per verificare il risultat dell elabrazine del servizi, il sistema client deve interrgare la piattafrma PCC mediante il servizi WS-QUERY Dati Fatture Access al servizi Per accedere ai servizi le Imprese devn richiedere l abilitazine al servizi attravers la funzine Utilità Gestine Deleghe WS dispnibile per gli utenti registrati. Al termine della prcedura di abilitazine gli utenti devn prvvedere al caricament del certificat per la mutua autenticazine 5 attravers la funzine Utilità Anagrafica Certificati WS 6 quindi attendere e verificare la cnclusine delle attività di installazine e cnfigurazine del certificat trasmess attravers la medesima funzine 7. Al cmpletament delle attività di installazine e cnfigurazine del certificat l Impresa abilitata può utilizzare il canale per la cnsultazine delle prprie fatture. In cas di delega ricevuta, pprtunamente registrata sul sistema attravers la funzine Utilità Gestine Deleghe WS, può utilizzare il canale web service anche per la cnsultazine delle fatture delle Imprese deleganti Riferimenti Infrastrutturali I servizi ggett del presente dcument sn resi dispnibili ai sistemi client delle Imprese attravers la seguente mdalità: Autenticazine dei sistemi client attravers l scambi di certificati digitali. L End-pint di access ai servizi è: Mutua autenticazine: 5 Certificat SSL Web Server rilasciat da una autrità di certificazine censita nell'elenc dei certificatri predispst dall'agid e prdtt secnd l standard X.509 v.3. 6 Al termine della perazine di caricament, il certificat sarà nell stat PROPOSTO. 7 Al termine delle perazini di installazine e cnfigurazine il certificat sarà nell stat ATTIVO. 10

11 PARTE II-DESCRIZIONE DEI SERVIZI Tutti i servizi previsti per l access alle funzini PCC attravers WS si caratterizzan per la mdalità di invcazine che può essere sincrna asincrna. L elenc dei servizi fferti è il seguente: ws-prxy dati fatture (servizi asincrn); ws-query dati fatture (servizi sincrn). 4. WS-PROXY Dati Fatture Il servizi cnsente ad un sggett trasmittente ad un Impresa, intermediari dell Impresa, di cnsultare i dati di una più fatture. Il servizi WS-Prxy Dati Fatture è asincrn e, una vlta invcat, restituisce sl infrmazini sulla crretta trasmissine (presa in caric). Si sservi che, per recuperare il risultat della elabrazine di quest servizi, ccrre invcare il crrispndente servizi sincrn (WS-QUERY Dati Fatture). Di seguit il dettagli della struttura del servizi Struttura del servizi WS-Prxy Dati Fatture Struttura della richiesta Di seguit è descritta la struttura della richiesta alla invcazine del servizi WS-Prxy Dati Fattura Testata richiesta: Cdice fiscale trasmittente Element valrizzat cn il Cdice Fiscale del sggett trasmittente della richiesta (Camp bbligatri) Identificativ transazine trasmittente Element valrizzat cn un identificativ della transazine frnit dal sggett trasmittente (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati richiesta: Filtr interrgazine La sezine riprta il filtr di ricerca ed è cstituit dai seguenti elementi, tutti i and lgic: Intervall Data emissine fatture La sezine cnsente di specificare un intervall temprale, cmpsta dai seguenti elementi: 11

12 Inizi Data Ricerca Data inizi intervall di ricerca delle fatture 8 Fine Data Ricerca data fine intervall di ricerca delle fatture 9 Identificativ Fiscale IVA Impresa il camp cnsente di specificare l identificativ fiscale IVA della Impresa della quale si intende ricercare le fatture. In assenza di quest parametr sarann ricercate tutte le fatture emesse dalle imprese per le quali il sggett trasmittente risulta abilitat alla cmunicazine via web service. Cdice Fiscale Amministrazine il camp cnsente di filtrare le fatture assciate alla Pubblica Amministrazine avente il cdice fiscale indicat ed emesse dalle Imprese per le quali il sggett trasmittente risulta abilitat alla cmunicazine via web service. In assenza di quest parametr sarann ricercate tutte le fatture emesse dalle imprese per le quali il sggett trasmittente è abilitat. Cdice Uffici IPA il camp cnsente di filtrare le sle fatture assciate all Uffici IPA indicat. In assenza di quest parametr sarann ricercate tutte le fatture emesse dalle imprese per le quali il sggett trasmittente risulta abilitat alla cmunicazine via web service. FLAG fatture variate il camp cnsente di filtrare le sle fatture variate rispett alla precedente invcazine del metd. In assenza di valrizzazine del camp si intende di default il valre SI 10. Valri ammessi: SI per filtrare le sle fatture variate rispett alla precedente invcazine NO per indicare che si nn si intende applicare il filtr. Stat Fattura il camp cnsente di filtrare le sle fatture avente cme stat un dei seguenti valri ammessi: IL = In Lavrazine BO = Bzza PR = Presentata RI = Ricevuta LA = Lavrata RE = Respinta. Struttura della rispsta Di seguit è descritta la struttura della rispsta alla invcazine del servizi WS-Prxy Dati Fattura Testata rispsta: Cdice fiscale trasmittente Element valrizzat cn il cdice fiscale del sggett trasmittente della richiesta (Camp bbligatri) Identificativ transazine trasmittente Element valrizzat cn un identificativ della transazine frnit dal sggett trasmittente (Camp bbligatri) 8 Se valrizzat, si intende che i risultati devn avere data emissine fattura >= della data Inizi Data Ricerca. Se nn valrizzat si intende cme data inizi dell intervall di ricerca il 01/01/ Se valrizzat, si intende che i risultati devn avere data emissine fattura <= della data Fine Data Ricerca. Se nn valrizzat si intende cme data fine intervall di ricerca la data di invi della richiesta. 10 In cas di acquisizine di una nuva delega da parte di una Impresa delegante sarann estratte, in cnfrmità cn il filtr di ricerca impstat, anche tutte le fatture relative alla nuva delega. 12

13 Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati rispsta: Identificativ transazine PCC Element valrizzat cn un identificativ della transazine frnit da PCC in rispsta all invcazine del servizi Esit Trasmissine Cdice esit per la presa in caric del servizi (Camp bbligatri). Può assumere i valri: OK = Cntrlli di presa in caric superati cn esit psitiv KO = Errre nei cntrlli di presa in caric Lista Errri Trasmissine Elenc di errri riscntrati nei cntrlli di presa in caric (la lista è vuta in cas di Esit Trasmissine = OK) Cdice esit trasmissine Element valrizzat cn un cdice esit trasmissine-tabella 1 - Cdici Esit Elabrazine e Trasmissine (Camp bbligatri) Descrizine esit trasmissine Element valrizzat cn la descrizine crrispndente al cdice esit trasmissine (Camp bbligatri) 4.2. Cntrlli sui dati Il servizi WS-Prxy Dati Fatture è di tip asincrn, pertant i cntrlli che vengn effettuati si distingun in cntrlli di presa in caric e cntrlli di elabrazine dati: i cntrlli di presa in caric sn effettuati per assicurare la crretta ricezine della richiesta i cntrlli di elabrazine dati sn di tip semantic e di business e vengn eseguiti sui dati durante l elabrazine del servizi. I risultati di questi cntrlli sn dispnibili sl attravers l invcazine del servizi WS-Query Dati Fatture. 13

14 Cntrlli di presa in caric Il servizi WS-Prxy Dati Fatture, alla presa in caric della richiesta, implementa i seguenti cntrlli funzinali ltre a quelli di validazine frmale della struttura dati: Cntrll su cdice fiscale trasmittente: Il cdice fiscale del trasmittente deve essere censit ed attiv sulla piattafrma PCC il trasmittente (identificat dal cdice fiscale trasmittente) deve essere abilitat ad perare per cnt dell Impresa identificata cn Identificativ Fiscale IVA Impresa, indicat nella richiesta di input Cntrll su Identificativ transazine trasmittente: l identificativ della transazine trasmittente nn deve essere già stat utilizzat in una precedente richiesta. Cntrll su Versine applicativa: il valre del camp Versine applicativa presente nella richiesta deve essere crrispndente a quell crrentemente usat dal sistema PCC. Per gni cntrll fallit il servizi inserirà la cppia cdice errre/descrizine nell elenc errri trasmissine. 14

15 Cntrlli di elabrazine dati Il servizi WS-Prxy Dati Fatture durante l elabrazine della richiesta, che avviene in mdalità asincrna rispett alla richiesta stessa, esegue ulteriri ed apprfnditi cntrlli sui dati il cui risultat viene res dispnibile tramite il servizi di WS-Query Dati Fatture. I cntrlli eseguiti durante l elabrazine del servizi, se nn sddisfatti, pssn prtare alla registrazine di esiti di errre (Errr Warning). I cdici di errri sn descritti in Tabella 1 - Cdici Esit Elabrazine e Trasmissine. I cntrlli di elabrazine sn descritti di seguit: cdice fiscale trasmittente: il sistema cntrlla che il cdice fiscale del trasmittente sia censit ed attiv e sia abilitat ad perare per cnt della Impresa identificata dall Identificativ Fiscale IVA Impresa, qualra indicat in input. 15

16 5. WS-QUERY Dati Fatture Il servizi WS-Query Dati Fatture cnsente ad una Impresa, intermediari dell Impresa, di cnsultare il risultat della elabrazine di una interrgazine richiesta tramite il crrispndente servizi WS-Prxy Dati Fatture. Il servizi WS-Query Dati Fatture è sincrn. Di seguit il dettagli della struttura del servizi Struttura del servizi WS-Query Dati Fatture Struttura della richiesta Di seguit è descritta la struttura della richiesta alla invcazine del servizi WS-Query Dati Fatture: Testata richiesta: Cdice fiscale trasmittente Element valrizzat cn il cdice fiscale del sggett trasmittente della richiesta (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Identificativ transazine trasmittente Element valrizzat cn un identificativ della transazine frnit dal sggett trasmittente (Camp bbligatri) Identificativ transazine PCC Element valrizzat cn un identificativ della transazine a cui si richiede l esit elabrazine. Tale identificativ è frnit dal sistema PCC in rispsta a una precedente richiesta del servizi WS- Prxy Dati Fatture. Dati richiesta: N.A. Struttura della rispsta Di seguit è descritta la struttura della rispsta alla invcazine del servizi WS-Query Dati Fatture. Testata rispsta Cdice fiscale trasmittente Element valrizzat cn il cdice fiscale del sggett trasmittente della richiesta Identificativ transazine trasmittente Element valrizzat cn l identificativ della transazine sulla quale si richiede il risultat della elabrazine Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati rispsta Esit Trasmissine Cdice esit per la presa in caric del servizi (Camp bbligatri). Può assumere i valri: OK = Cntrlli di presa in caric superati cn esit psitiv 16

17 KO = Errre nei cntrlli di presa in caric Lista Errri Trasmissine Elenc di errri riscntrati nei cntrlli di presa in caric (la lista è vuta in cas di Esit Trasmissine = OK) Cdice esit trasmissine Element valrizzat cn un cdice esit trasmissine-tabella 1 - Cdici Esit Elabrazine e Trasmissine (Camp bbligatri) Descrizine esit trasmissine Element valrizzat cn la descrizine crrispndente al cdice esit trasmissine (Camp bbligatri) Esit elabrazine transazine Element valrizzat cn un cdice esit elabrazine; può assumere i valri: OK = Cntrlli di presa in caric superati cn esit psitiv KO = Errre nei cntrlli di presa in caric Descrizine elabrazine transazine Element valrizzat cn la descrizine crrispndente al cdice esit elabrazine Data fine elabrazine Element valrizzat cn la data-ra di fine elabrazine della richiesta Lista URL Element valrizzat cn l elenc di url ad gnun dei quali è dispnibile un file per l perazine di dwnlad Url File Fatture Il camp riprta la stringa cntenente le infrmazini necessarie per effettuare il dwnlad del file cntenente i dati delle fatture mediante prtcll ftp e la relativa perazine di decdifica del file. Il camp è strutturat nel seguente md <CHIAVE> <VETTORE_INIZIALIZZAZIONE> <URL_FILE> <CHIAVE> Valre di lunghezza di 16 byte e cdificat in frmat esadecimale; <VETTORE_INIZIALIZZAZIONE> Valre di lunghezza di 16 byte e cdificat in frmat esadecimale; < URL_FILE > stringa cntenente l url per la cnnessine cn prtcll ftp necessaria per il dwnlad del file. La durata di validità dell url è di 36 re dalla generazine dell stess ed una vlta effettuat il dwnlad il file nn sarà più dispnibile per ulteriri perazini di dwnlad. I file resi dispnibili agli url specificati nella rispsta, riprtan le infrmativi relative alle fatture richieste attravers il crrispndente servizi WS-PROXY Dati Fatture. I file sn nel frmat cmpress e crittat.zip.enc, ssia risultanti da un prcess di cmpressine di file in frmat xml cnfrmi all schema riprtat nella sezine Schema dati fatture e da una successiva perazine di crittatura del file cmpress. L'algritm utilizzat per l perazine di crittatura è AES-128 in mdalità CBC cn padding PKCS5 descritt dall standard di riferiment RFC Per la decdifica del file è pertant richiesta la cppia chiave/vettre di inizializzazine riprtati nel camp Url File Fatture. 17

18 Nel cas di un file in frmat xml di grandi dimensini il prcess di cmpressine frazina il risultat su più file prducend un file in frmat.zip.enc ed un più file in frmat.z0n.enc Cntrlli sui dati Il servizi WS-Query Dati Fatture, alla presa in caric della richiesta, implementa i seguenti cntrlli funzinali ltre a quelli di validazine frmale della struttura dati: Cntrll su cdice fiscale trasmittente: il cdice fiscale del trasmittente deve essere un cdice censit ed attiv sulla piattafrma PCC Cntrll su Identificativ transazine trasmittente: l identificativ della transazine trasmittente deve essere assciat ad una elabrazine richiesta dal sggett trasmittente indicat nel camp cdice fiscale Trasmittente presa in caric dal sistema PCC (vver sia assciat ad un identificativ generat da PCC). Cntrll su Identificativ transazine PCC: l identificativ della transazine PCC deve essere assciat ad una elabrazine presa in caric dal sistema PCC e deve essere uguale a quell assciat all'identificativ transazine trasmittente. Per gni cntrll fallit il servizi inserirà la cppia cdice errre/descrizine nell elenc errri trasmissine Schema dati fatture Il file restituit in allegat al messaggi di rispsta del servizi WS-QUERY Dati Fatture è cnfrme al seguente schema: Lista dettagli fatture: la sezine riprta un elenc di dettagli fatture, gnun cstituit dai seguenti campi: Dettagli Fattura La sezine presenta i dati di dettagli della fattura cmprensivi di mvimentazine ed è cmpsta dai seguenti elementi Dati Frnitre Element cstituit da due campi: Cdice Fiscale Cdice fiscale del Frnitre che ha emess il dcument Denminazine Denminazine del frnitre che ha emess il dcument Dati Cessinari Element cstituit da due campi: Cdice Fiscale Cdice fiscale del sggett cessinari del dcument Denminazine Denminazine del sggett cessinari del dcument 11 Ad esempi un prcess di cmpressine che frazina il risultat su tre file, al termine del prcessa sarann dispnibili i seguenti file: fatture.zip, fatture.z01, fatture.z02. 18

19 Data cessine Dati Amministrazine Element cstituit dai seguenti campi: Cdice Fiscale Cdice fiscale dell amministrazine destinataria del dcument Denminazine Denminazine dell'amministrazine destinataria del dcument Cdice Uffici PCC Denminazine Uffici PCC Cdice Univc Uffici di IPA Denminazine Uffici IPA Dati Distinta Trasmissine Element cstituit dai seguenti campi Identificativ Distinta Data Immissine Flag Fattura Certificata Valri ammissibili SI/NO Elenc certificazini Sezine cmpsta dalla sequenza: Numer istanza Identificativ istanza di certificazine Numer certificazine Identificativ certificazine credit (assciat al numer istanza) Imprt ttale cmunicazini scadenze Definisce l imprt ttale del credit già inserit nel pian cmunicazini scadenze Elenc Cmunicazine Scadenza Sezine cmpsta dalla sequenza: Pian Cmunicazine scadenza Sezine cmpsta da: Data scadenza Data scadenza cmunicata Imprt Imprt in scadenza Imprt iniziale Imprt iniziale della cmunicazine Pagat/Ricntabilizzat Quta parte dell imprt pagat ricntabilizzat Dati Dcument La sezine è cstituita dai seguenti dati di dettagli del dcument: Stat dcument Element che può assumere i seguenti valri IL = In Lavrazine BO = Bzza PR = Presentata 19

20 RI = Ricevuta LA = Lavrata RE = Respinta Id fiscale IVA Specifica il numer di identificazine fiscale del Frnitre ai fini IVA nel frmat IT Prgressiv Registrazine Identificazine SDI Struttura cmpsta da i seguenti elementi Ltt SDI Numer Fattura Numer Prtcll Data Ricezine Tip dcument Element che assume un dei seguenti valri TD01 = fattura TD02 = accnt/anticip su fattura TD03 = accnt/anticip su parcella TD04 = nta di credit TD05 = nta di debit TD06 = parcella Data emissine Numer dcument Descrizine Causale Imprt ttale Imprt impnibile Ttale impsta Split Payment : valri ammissibili SI/NO Lista Riepilg Aliqute La sezine riprta un elenc di elementi Riepilg Aliqute, definit cme segue Riepilg Aliqute La sezine è cstituita dai seguenti dati: Aliquta IVA Specifica l aliquta IVA applicata alla fattura Cdice Esenzine IVA Specifica l eventuale cdice di esenzine IVA, valri ammissibili NA: nn applicabile N1: escluse ex art. 15 N2: nn sggette N3: nn impnibili N4: esenti N5: regime del margine Ttale Impnibile Aliquta 20

21 Ripartizine attuale Sezine cmpsta dai seguenti elementi Specifica l imprt ttale impnibile assciat all aliquta IVA ppure al cdice di esenzine IVA Ttale Impsta Aliquta Specifica l imprt ttale dell impsta assciat all aliquta IVA Imprt liquidat Imprt nn liquidat Imprt sspes Imprt pagat Data certificazine Imprt Certificat Elenc Pagamenti Sezine cmpsta da una sequenza di Dettagli Pagament Dettagli Pagament Sezine cmpsta dai seguenti elementi Data riferiment termini pagament Specifica la data dalla quale decrrn i termini di pagament Girni termini pagament Specifica il numer di girni entr i quali sarà effettuat il pagament Data scadenza pagament Imprt pagament 21

22 6. WS-READ Stat Fattura Il servizi cnsente ad una Impresa di cnscere l stat di una fattura. Il servizi WS-Read Stat Fattura è sincrn e, una vlta invcat, restituisce le infrmazini sull stat cntabile di una fattura (determinat dalle cntabilizzazini, dalle cmunicazini di scadenza, dai pagamenti, ecc.). Di seguit il dettagli della struttura del servizi Struttura del servizi WS-Read Stat Fattura Struttura della richiesta Di seguit è descritta la struttura della richiesta alla invcazine del servizi WS-Read Stat Fattura Testata richiesta: Cdice fiscale trasmittente Element valrizzat cn il cdice fiscale del sggett trasmittente della richiesta (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati richiesta: Dati identificativi fattura La sezine è cstituita dai dati identificativi della fattura 12 e, in mutua esclusine, da un dei seguenti elementi Identificazine PCC Element che identifica il Numer Prgressiv di Registrazine PCC della fattura attribuit dal sistema PCC in fase di ricezine Identificazine SDI Struttura cmpsta dai seguenti elementi: Ltt SDI (Camp bbligatri) Numer Fattura (Camp bbligatri) Identificazine generale Struttura cmpsta dai seguenti elementi: Numer fattura 13 (Camp bbligatri) Data emissine 14 (Camp bbligatri) 12 SDI 2.1 DatiGenerali 13 SDI Numer 14 SDI Data 22

23 Struttura della rispsta Imprt ttale dcument 15 (Camp bbligatri) Id Fiscale IVA frnitre 16 (Camp bbligatri) Di seguit è descritta la struttura della rispsta alla invcazine del servizi WS-Read Stat Fattura Testata rispsta: Cdice fiscale trasmittente Element valrizzat cn il cdice fiscale del sggett trasmittente della richiesta (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati rispsta: Esit Trasmissine Cdice esit per la presa in caric del servizi (Camp bbligatri). Può assumere i valri: OK = Cntrlli di presa in caric superati cn esit psitiv KO = Errre nei cntrlli di presa in caric Lista Errri Trasmissine Elenc di errri riscntrati nei cntrlli di presa in caric (la lista è vuta in cas di Esit Trasmissine = OK) Cdice esit trasmissine Element valrizzat cn un cdice esit trasmissine- Tabella 1 - Cdici Esit Elabrazine e Trasmissine(Camp bbligatri) Descrizine esit trasmissine Element valrizzat cn la descrizine crrispndente al cdice esit trasmissine (Camp bbligatri) Data fine elabrazine Element valrizzat cn la data-ra di fine elabrazine della richiesta Stat Cntabile Fattura La sezine presenta i dati di sintesi della fattura, ed è cmpsta dai seguenti elementi Dati Frnitre Element cstituit da due attributi Cdice Fiscale Cdice fiscale del frnitre che ha emess il dcument Denminazine Denminazine del frnitre che ha emess il dcument Dati Amministrazine Element cstituit dai seguenti campi Cdice Fiscale Cdice fiscale dell amministrazine destinataria del dcument Denminazine Denminazine dell amministrazine destinataria del dcument Cdice Uffici PCC 15 SDI ImprtTtaleDcument 16 Numer di identificazine fiscale ai fini IVA. Nel cas di partita IVA, i primi due caratteri rappresentan il paese di rigine (es. IT) ed i restanti caratteri (fin ad un massim di 11) il cdice numeric di Partita IVA (es. IT ). Nel cas di Cdici Fiscali devn essere indicati 16 caratteri alfanumerici. 23

24 Denminazine Uffici PCC Cdice Univc Uffici di IPA Denminazine Uffici IPA Dati Distinta Trasmissine Element cstituit dai seguenti campi: Identificativ Distinta Data Immissine Dati Dcument La sezine è cstituita dai seguenti dati di dettagli del dcument: Stat dcument Element che può assumere i seguenti valri IL = In Lavrazine BO = Bzza PR = Presentata RI = Ricevuta LA = Lavrata RE = Respinta Id fiscale IVA Specifica il numer di identificazine fiscale ai fini IVA nel frmat IT (Camp bbligatri) Prgressiv Registrazine Numer Prtcll Data Ricezine Tip dcument Element che assume un dei seguenti valri: TD01 = fattura Data emissine TD02 = accnt/anticip su fattura TD03 = accnt/anticip su parcella TD04 = nta di credit TD05 = nta di debit TD06 = parcella Numer dcument Descrizine Causale Imprt ttale Imprt impnibile Ttale impsta Split Payment Valri ammissibili SI/NO Ripartizine attuale Sezine cmpsta dai seguenti elementi: 24

25 Imprt liquidat Imprt nn liquidat Imprt sspes Imprt pagat Data certificazine Imprt Certificat 6.2. Cntrlli sui dati Il servizi WS-Read Stat Fattura è di tip sincrn, i cntrlli effettuati sn quindi cntempraneamente sia di presa in caric sia di elabrazine dati, secnd la distinzine riprtata nel seguit. I cntrlli eseguiti durante l elabrazine del servizi, se nn sddisfatti, pssn prtare alla registrazine di esiti di errre (Errr Warning). Per gni cntrll fallit il servizi genererà un pprtun messaggi di errre interrmpend la lavrazine della richiesta (cfr in Cdici Esit Elabrazine e Trasmissine). I cntrlli di presa in caric sn descritti di seguit: Cntrll su cdice fiscale trasmittente: il cdice fiscale del trasmittente deve essere censit ed attiv sulla piattafrma PCC. il trasmittente (identificat dal cdice fiscale trasmittente) deve esser abilitat ad perare per cnt della Impresa identificata cn Identificativ Fiscale IVA titlare della fattura per la quale si effettua l interrgazine. Cntrll su Versine applicativa: il valre del camp versine applicativa presente nella richiesta deve essere crrispndente a quell crrentemente usat dal servizi PCC. I cntrlli di elabrazine sn descritti di seguit: Dati identificativi della fattura: il sistema cntrlla che il trasmittente (identificat dall element cd. fiscale trasmittente) abbia i diritti di cnsultazine sulla fattura. 25

26 7. WS-READ Interrgazine Esiti Il servizi cnsente ad un Impresa, intermediari dell Impresa, di cnsultare l stat di elabrazine di una più transazini di prpria cmpetenza effettuate sul sistema PCC attravers i web-services. Il servizi WS-Read Interrgazine Esiti è sincrn, ed è prevista la pssibilità di impstare dei criteri di ricerca. Di seguit il dettagli della struttura del servizi Struttura del servizi WS-Read Interrgazine Esiti Struttura della richiesta Di seguit è descritta la struttura della richiesta alla invcazine del servizi WS-Read Interrgazine Esiti Testata richiesta: Cdice fiscale trasmittente Element valrizzat cn il Cdice Fiscale del sggett trasmittente della richiesta (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati richiesta: Filtr interrgazine La sezine riprta il filtr di ricerca bbligatri ed è cstituit, in mutua esclusine, da un dei seguenti elementi: Elenc Transazine Trasmittente Sezine cmpsta di una sequenza di elementi identificativi transazine del sggett trasmittente: Identificativ transazine PA Element valrizzat cn un identificativ della transazine frnit dal chiamante (Camp bbligatri) Elenc Transazine PCC Sezine cmpsta di una sequenza di elementi identificativi transazine PCC: Identificativ transazine PCC (Camp bbligatri) Intervall Date La sezine cnsente di specificare un intervall temprale di ampiezza massima pari a 5 girni, cmpsta dai seguenti elementi: Inizi Data Richiesta Elabrazine 26

27 Data inizi intervall di ricerca delle transazini sulle quali è stata richiesta un elabrazine 17 (Camp bbligatri) Fine Data Richiesta Elabrazine Data fine intervall di ricerca delle transazini sulle quali è stata richiesta un elabrazine 18 (Camp bbligatri) Flag Esiti Nn Cmunicati Element che, se valrizzat cn SI, include nei risultati della richiesta sl le elabrazini terminate, cn esit psitiv cn errre, che nn sian state cmunicate in precedenti interrgazini. Nn sn incluse nei risultati, le elabrazini cn stat transazine presa in caric e transazine in lavrazine. Valri ammissibili: SI Il filtr viene applicat NO Il filtr nn viene applicat (valre default) Numer pagina Il camp riprta il numer della pagina di esiti da estrarre. In cas di mancata valrizzazine del camp, sarà estratta la prima pagina di esiti. Struttura della rispsta Di seguit è descritta la struttura della rispsta alla invcazine del servizi WS-Read Interrgazine Esiti Testata richiesta: Cdice fiscale trasmittente Element valrizzat cn il Cdice Fiscale del sggett trasmittente della richiesta (Camp bbligatri) Timestamp trasmissine Element valrizzat cn la data-ra di trasmissine della richiesta (Camp bbligatri) Versine applicativa Element valrizzat cn un identificativ della versine applicativa del sistema PCC (Camp bbligatri) Dati rispsta: Esit Trasmissine Cdice esit per la presa in caric del servizi (Camp bbligatri) Può assumere i valri OK = Cntrlli di presa in caric superati cn esit psitiv KO = Errre nei cntrlli di presa in caric Lista Errri Trasmissine Elenc di errri riscntrati nei cntrlli di presa in caric (la lista è vuta in cas di Esit Trasmissine = OK) Cdice esit trasmissine Element valrizzat cn un cdice esit trasmissine- Tabella 1 - Cdici Esit Elabrazine e Trasmissine(Camp bbligatri) Descrizine esit trasmissine Element valrizzat cn la descrizine crrispndente al cdice esit trasmissine (Camp bbligatri) Data fine elabrazine Element valrizzat cn la data-ra di fine elabrazine della richiesta Paginazine 17 Se valrizzat, si intende che i risultati devn avere data elabrazine >= della data Inizi Data Richiesta Elabrazine 18 Se valrizzat, si intende che i risultati devn avere data elabrazine <= della data Fine Data Richiesta Elabrazine 27

28 La sezine riprta le infrmazini relative al numer di pagine e risultati estratti cn il filtr applicat in input. È cstituit dai seguenti campi: Pagina crrente Element valrizzat cn il numer della pagina crrente di risultati della ricerca Numer pagine Element rappresentante il numer ttale di pagine di risultati ttenuti cn l applicazine del filtr di interrgazine in input Numer ttale elementi Element che rappresenta il numer ttale di elementi ttenuti cn l applicazine del filtr di interrgazine in input Elenc Esiti Transazini Sezine cmpsta da una sequenza di elementi: Identificativ transazine PCC element valrizzat cn un identificativ della transazine frnit da PCC in rispsta alla invcazine del servizi Identificativ Transazine Impresa Element valrizzat cn un identificativ della transazine frnit dal chiamante Identificativ Fiscale IVA Element valrizzat cn l identificativ Fiscale IVA dell Impresa Stat Transazine Element che può assumere un dei seguenti valri Transazine in attesa di elabrazine Transazine in crs di elabrazine Transazine elabrata cn esit psitiv Transazine elabrata cn esit negativ Cntrlli sui dati Il servizi WS-Read Interrgazine Esiti è di tip sincrn, i cntrlli effettuati sn quindi cntempraneamente sia di presa in caric sia di elabrazine dati, secnd la distinzine riprtata nel seguit. I cntrlli eseguiti durante l elabrazine del servizi, se nn sddisfatti, pssn prtare alla registrazine di esiti di Errr Warning. Per gni cntrll fallit il servizi genererà un pprtun messaggi di errre interrmpend la lavrazine della richiesta (cfr in Tabella 1 - Cdici Esit Elabrazine e Trasmissine). I cntrlli di presa in caric sn descritti di seguit: Cntrll su cdice fiscale trasmittente: il cdice fiscale del trasmittente deve essere censit ed attiv sulla piattafrma PCC il trasmittente (identificat dal cdice fiscale trasmittente) deve essere abilitat ad perare per cnt dell Impresa identificata dall Identificativ Fiscale IVA Impresa, qualra indicat nei dati di input. 28

29 Versine applicativa: il valre del camp Versine applicativa presente nella richiesta deve essere crrispndente a quella crrentemente usat dal servizi PCC. I cntrlli di elabrazine sn descritti di seguit: Cntrll su Intervall Date: il sistema cntrlla che, se valrizzat, l element Inizi Data Richiesta Elabrazine cntenga una data nn successiva alla data inserita nell element Fine Data Richiesta Elabrazine. Se viene valrizzat l element Fine Data Richiesta Elabrazine cntenga una data nn precedente alla data inserita nell element Inizi Data Richiesta Elabrazine. Inltre il sistema cntrlla che l ampiezza massima dell element Intervall Date sia di 5 girni. Cntrll mutua esclusine filtri: il sistema cntrlla che nella sezine Filtr interrgazine nn vengan valrizzati cntempraneamente i filtri Elenc Transazine Impresa, Elenc Transazine PCC e Intervall Date. Cntrll di visibilità sulle elabrazini richieste: il sistema cntrlla che gli identificativi di transazine richiesti (sia PCC che Trasmittente) appartengan al cn di visibilità del richiedente. 29

30 8. Metd di test Il servizi cnsente al sistema trasmittente di effettuare un invcazine di test per verificare la crretta cmunicazine cn il web-service. Di seguit il dettagli della struttura del servizi Struttura del servizi TestWS Struttura della richiesta Il metd di test nn prevede dati di input. Struttura della rispsta Di seguit è descritta la struttura della rispsta all invcazine del servizi testws. Dati rispsta: il camp riprta una stringa generata dall applicazine PCC. 30

31 PARTE III- Appendice 9. Cdici Esit Elabrazine e Trasmissine Cdice Descrizine Tiplgia E000 Errre generic Errre di presa in caric richiesta E9999 Servizi mmentaneamente nn dispnibile Errre di presa in caric richiesta FW0001 Errre di validazine parametri di Input: Cdice Errre di presa in caric richiesta Fiscale Trasmittente nn valrizzat nn valid FW0004 Errre di validazine parametri di Input: Versine Errre di presa in caric richiesta Applicativa nn valrizzat nn crrispndente a quella crrentemente usata dal servizi PCC FW0007 Errre di validazine parametri di Input: Timestamp Errre di presa in caric richiesta trasmissine nn presente nn valid FW0009 Identificativ transazine Pcc nn valid inesistente Errre di presa in caric richiesta FW0010 La transazine è ancra in stat: {0} Errre di elabrazine FW0011 La transazine è terminata cn errre Errre di elabrazine FW0012 Il numer di girni fra le due date specificate nn Errre di presa in caric richiesta pu essere superire a {0} girni FW0013 La pagina specificata nn esiste Errre di presa in caric richiesta FW0014 L identificativ transazine impresa è già stat Errre di presa in caric richiesta utilizzat. FW0015 La transazine a cui si fa riferiment nn è stata Errre di presa in caric richiesta trvata. FW0016 L identificativ transazine impresa nn è stat Errre di presa in caric richiesta valrizzat. FW1000 Errre di validazine parametri di Input: Data inizi Errre di presa in caric richiesta richiesta successiva alla data fine richiesta FW8004 Nn è pssibile sttmettere più di una richiesta Errre di presa in caric richiesta PrxyDatiFatture per vlta FW20000 Nn è stat specificat alcun criteri di Errre di presa in caric richiesta individuazine della fattura su cui agire FW20001 Deve essere specificat un sl filtr per la ricerca Errre di presa in caric richiesta della fattura FW20004 Il trasmittente nn è abilitat alla visualizzazine Errre di elabrazine delle fatture per l IdentificativFiscaleIvaImpresa {0} FW20005 Errre in fase di generazine del file ZIP-XML delle Errre di elabrazine fatture FW20006 Errre in fase di uplad del file di risultat sull'ftp Errre di elabrazine pubblic FW20007 Il trasmittente nn risulta abilitat per nessuna Errre di elabrazine impresa FW40007 La fattura specificata nn è visibile Errre di presa in caric richiesta, errre di elabrazine FW80000 Credenziali nn valide (Username_CdiceCanale Errre di presa in caric richiesta 31

32 FW80001 FW80002 FW80003 Passwrd nn valrizzati) Credenziali nn valide (Username_CdiceCanale nn Errre di presa in caric richiesta censit nel Sistema) Credenziali nn valide (Passwrd TipCanale nn Errre di presa in caric richiesta validi) Credenziali nn valide (Il TipCanale nn crrispnde Errre di presa in caric richiesta all utenza Username_CdiceCanale-Passwrd) Tabella 1 - Cdici Esit Elabrazine e Trasmissine 32

33 La tabella seguente riprta la mappatura cdice errre/perazini: Cdice Ws-Prxy Dati Fatture Ws-Query Dati Fatture Ws-Read Stat Fattura Ws-Read Interrgazine Esiti E000 X X X X E9999 X X X X FW0001 X X X X FW0004 X X X X FW0007 X X X X FW0009 X X FW0010 X FW0011 X FW0012 X FW0013 X FW0014 X FW0015 X FW0016 X FW1000 X FW8004 X FW20000 X FW20001 X FW20004 X X FW20005 X FW20006 X FW20007 X X X X FW40007 X FW80000 X X X X FW80001 X X X X FW80002 X X X X FW80003 X X X X Tabella 2 - mappatura errre/perazini 33

34 10. Scheda web service Nme tiplgia di Sggetti fruitri: Imprese abilitate Nme del WSDL: PCC_WSFATTIMPRESE_v1.0.wsdl Attachment (gestine allegati): SI senza manifest Uri (endpint) del servizi applicativ: Nme fisic metd (prttype) Nme lgic metd wsprxydatifatture wsprxydatifatture wsquerydatifatture wsquerydatifatture wsreadstatfattura wsreadstatfattura wsreadinterrgazineesiti wsreadinterrgazineesiti testws testws 34