RITIRO DIGITALE SCHEDA TECNICA. Ed. Novembre 2017 PRENOTAZIONE

Transcript

1 RITIRO DIGITALE SCHEDA TECNICA Ed. Novembre 2017 PRENOTAZIONE 1

2 INDICE 1 SCOPO E CAMPO DI APPLICAZIONE PRODOTTI IN AMBITO ATTIVAZIONE DEL SERVIZIO PRENOTAZIONE DELLE SPEDIZIONI Informazioni preliminari Sezione 1: Visualizza Centri di postalizzazione Sezione 2: Richiedi ID Prenotazione Sezione 3: Ricerca ID Prenotazione Inserimento distinta analitica di prenotazione Specifica distinta analitica di prenotazione Nomenclatura Struttura del file Header Body Possibili errore comunicati in fase di validazione distinta Controlli sui campi dell Header Controlli sui campi del Body Comunicazione esito della validazione della Distinta di Prenotazione Tracciato File CSV Esito Prenotazione OK Tracciato File CSV Bad Analitica OK Tracciato File CSV Righe Scartate OK Tracciato File CSV Esito Prenotazione KO Upload Distinta Analitica di Prenotazione via SFTP Upload Distinta Analitica di Prenotazione via Web Service Interfaccia Richiesta ID Prenotazione ID Inserimento Distinta Analitica di Prenotazione Recupero notifiche Componente Message Delivery...29

3 4.6.3 Dettagli del processo di acquisizione da eseguire Modello del dominio MessageType MessageContentType DestinationType Base Fault Type UPLOAD FILE ARCHIVIO PDF Informazioni preliminari Struttura dei file in input Struttura del file indici di tipologia XML Intestazione del file XML Sezione di dichiarazione delle chiavi Sezione di valorizzazione delle chiavi Sezione di riepilogo delle informazioni Struttura del file.inf File di Informazioni generali Sezione Info Job Sezione Info archive Esempio di file inf Ricevute di accettazione flussi.cpx Esempio di ricevuta di Presa in carico del Flusso con esito Positivo (J00) Esempio di ricevuta di Presa in carico del Flusso con esito Negativo (E00) Ricevute di completamento caricamento su documentale Upload file archivio pdf via web service Metodi esposti Metodo SendRequest Parametri di input Strutture oggetto Esempio di chiamata Ritorno del modello Descrizione degli errori WSDL...50

4 5.8 Download raccomandate digitali e ar\ac via web service Metodo di Ricerca Metodo di Download WSDL Metodo di Ricerca Metodo di Download APPENDICE DETTAGLIO ERRORI PSONLINE...70

5 1 SCOPO E CAMPO DI APPLICAZIONE Ritiro Digitale è il servizio di Poste Italiane che consente al destinatario di un invio di posta registrata di ritirare quest ultima in modalità digitale in alternativa al processo fisico; a tale scopo è necessario che chi effettua la spedizione (di seguito Cliente ) abbia attivato la relativa funzionalità. Il presente documento ha lo scopo di illustrare il processo di affido dei File Digitali delle Raccomandate e della Distinta di Prenotazione che il Cliente, oppure il Service per suo conto del Cliente, dovrà eseguire per abilitare ai propri Destinatari alla funzionalità di Ritiro Digitale. A garanzia dell immodificabilità del contenuto dell invio Poste Italiane appone sui file ricevuti una marca temporale nonché la firma digitale di un proprio responsabile. 1 Ritiro Digitale costituisce un servizio al destinatario, persona fisica residente sul territorio italiano, ed, in quanto tale, non determina alcun onere aggiuntivo per il Cliente mentre comporta il pagamento di un corrispettivo a carico del destinatario. Sono pre-requisiti senza i quali la funzionalità non può essere erogata l acquisto da parte del destinatario dei seguenti fattori abilitanti: un Identità Digitale (allo stato, PosteID di secondo livello), la Firma Digitale Remota PosteID. Il Servizio è disponibile per le tipologie di posta registrata riportate nell apposito elenco pubblicato sul sito e, comunque, nei soli casi in cui il destinatario abbia ricevuto un apposito avviso di giacenza recante le informazioni relative alla modalità di ritiro in digitale.

6 2 PRODOTTI IN AMBITO Di seguito i Prodotti in ambito: Raccomandata Smart Raccomandata PRO 2

7 3 ATTIVAZIONE DEL SERVIZIO I Clienti/Service che intendono effettuare postalizzazioni con Servizio Ritiro Digitale devono: 1. Registrarsi sul portale ed al servizio Prenotazione Spedizioni Online accessibile dalla MyPoste in fase di Post-Login; 2. Programmare ciascuna postalizzazione utilizzando il Servizio Prenotazione Spedizioni Online; come da specifiche riportate nei successivi paragrafi. Di seguito gli step di processo necessari per l abilitazione del Servizio Ritiro Digitale: Richiesta una-tantum, tramite poste.it, degli ID Prenotazione sulla piattaforma Prenotazione Spedizioni (PSOnline); 3 Invio, tramite area di scambio SFTP, alla piattaforma Prenotazione Spedizioni (PSOnline) di un flusso digitale contenente la Distinta di Prenotazione Elettronica di Posta Registrata (.DU) associata ad un ID Prenotazione contenuto nel range assegnato. Nella distinta di prenotazione, per ogni singolo invio, dovrà essere riportato il Codice Fiscale del Destinatario e l abilitazione o meno al Servizio Ritiro Digitale. La prenotazione, effettuata mediante Cartelle di scambio SFTP, va effettuata entro le ore 24 del giorno precedente la data di accettazione della postalizzazione. Invio, tramite area di scambio SFTP, alla piattaforma di Archiviazione Documenti, un flusso digitale contenente i File PDF (identici alle raccomandate cartacee che verranno stampate); a valle dell acquisizione Poste Italiane provvederà a Firmare e marcare digitalmente a nome di Poste Italiane. L invio del flusso digitale contenente i File PDF, effettuato mediante Cartelle di scambio SFTP, va effettuato entro le ore 24 del giorno precedente della data di accettazione della postalizzazione.

8 A valle del processo di affido dei flussi digitali il Cliente riceverà: File di esito caricamento Distinta di Prenotazione Elettronica; File di esito archiviazione dei File PDF. Nota: Il servizio di Ritiro Digitale non è, al momento, disponibile per la città di Napoli e per la località di Follonica fino a diverso avviso che sarà pubblicato sulle pagine di prodotto poste.it nella sezione dedicata di Ritiro Digitale 4 Si precisa che le Distinte Elettroniche di Accettazione non sostituiscono in alcun modo le Distinte Cartacee che accompagnano la postalizzazione in Accettazione Grandi Clienti.

9 4 PRENOTAZIONE DELLE SPEDIZIONI 4.1 Informazioni preliminari Sul portale business di poste.it, il Cliente/Service abilitato può accedere con le sue credenziali alla sezione Prenotazione Spedizioni. I passi preliminari necessari per effettuare una prenotazione sono i seguenti: 1. Conoscere il centro di accettazione della postalizzazione tra quelli disponibili nella sezione 1 delle Utilities (Visualizza Centri Postalizzazione) 2. Avere a disposizione dei codici ID prenotazione richiesti attraverso la sezione 2 delle Utilities (Richiedi ID Prenotazione) 5 La sezione 3 della Utilities (Ricerca ID Prenotazione) permette invece al cliente di effettuare una ricerca tra i codici prenotazione già utilizzati o da utilizzare tra quelli precedentemente richiesti.

10 4.1.1 Sezione 1: Visualizza Centri di postalizzazione In questa sezione il cliente potrà visualizzare i centri presso cui è possibile accettare il prodotto di posta selezionato nonché il frazionario che dovrà successivamente essere inserito all interno della Distinta Analitica di Prenotazione Sezione 2: Richiedi ID Prenotazione In questa sezione è possibile richiedere i codici ID Prenotazione secondo la numerosità desiderata; la procedura restituisce un range numerico consecutivo e senza interruzioni.

11 Gli ID Prenotazione nella Distinta Analitica di Prenotazione (valore numerico). 7 Il cliente, oltre alla visualizzazione da portale, avrà la possibilità di esportare i codici IDprenotazione in file formato CSV.

12 Il sistema invierà al cliente una mail (all indirizzo associato all utenza Poste. it) contenente una copia dei codici ID Prenotazione esposti dal portale. 8

13 4.1.3 Sezione 3: Ricerca ID Prenotazione In tale sezione, il cliente ha la possibilità di recuperare i codici IDprenotazione precedentemente forniti dal sistema e non ancora utilizzati Inserimento Distinta Analitica di Prenotazione Ottenuto il codice ID Prenotazione e scelto il centro presso cui postalizzare (con relativo frazionario) il cliente per completare la prenotazione dovrà caricare la Distinta analitica di prenotazione selezionando Inserimento distinta analitica

14 In tale sezione il cliente seleziona Caricamento file.csv, sceglie il file che desidera caricare ed effettua il caricamento cliccando su «Invia Prenotazione»: Il sistema conferma l esito di caricamento del file Specifica Distinta Analitica di Prenotazione Nomenclatura La Distinta di Prenotazione deve avere la seguente nomenclatura: <descrizione_servizio>_<tipo_accettazione>_<tipologia_file>_<codice_ sap>_<id_prenotazione>_<progressivo_postalizzazione>_<sigla_ids>.du dove: <descrizione_servizio> (varchar 4): fisso a NPSO ; <tipo_accettazione> (char 1): fisso a G, identifica il canale Grandi Utenti; <tipologia_file> (varchar 2): fisso a DU, identifica la tipologia di Distinta di Prenotazione;

15 <codice_sap> (varchar 10): ID + Codice SAP del Cliente che prenota; <id_prenotazione> (varchar 7): ID Prenotazione rilasciato da PsOnline, deve coincidere con il campo ID Prenotazione riportato sull header della Distinta (rif. Par ); <progressivo postalizzazione> (varchar 2): progressivo della postalizzazione <sigla_ids>(varchar 4): valorizzata solo in caso di Posta Descritta con servizio Infodelivery Standard. Esempi: Senza servizio Infodelivery Standard: NPSO_G_DU_ ID _ _01.DU Con servizio Infodelivery Standard: NPSO_G_DU_ ID _ _01_CLIE.DU Il file DU deve essere contenuto all interno di un archivio compresso.zip Struttura del file La Distinta Analitica di Prenotazione è un file CSV separato dal carattere ( pipe); eventuali decimali devono utilizzare il carattere punto (.) come separatore. 11

16 Header Nome campo Descrizione Tipo Lunghezza Obbligatorio Codice Cliente ID SAP Cliente Varchar 10 SI Utenza operatore Cliente ID Prenotazione Data ricezione flusso Data fine stampa service Data di postalizzazione Frazionario centro Codice Famiglia Prodotto Codice Prodotto Servizio Accessorio Numero Oggetti Processo di accettazione Tipologia codice di tracciatura Codice conto contrattuale Utenza del prenotatore sul quale si controlla la relazione cliente service Codice della prenotazione scaricato preventivamente da Psonline; deve coincidere con l ID Prenotazione riportato sul nome file della Distinta Data e Ora di Accettazione del lotto di stampa da parte del Service, nel formato aaaamm-gg Data e Ora di Fine stampa del lotto da parte del Service nel formato aaaa-mm-gg Data e ora pianificata di postalizzazione nel formato aaaa-mm-gg Frazionario del centro di accettazione Fisso a R, identifica la Famiglia Registrata. ID del Prodotto riportato nella Tabella Prodotti. Valorizzato con IDS se richiesto il servizio di rendicontazione esiti Infodelivery Standard. Campo numerico che indica il numero totale di invii/pacchi costituenti la spedizione. ID del Processo riportato nella Tabella Processi di Accettazione. Fisso a 2, identifica il Codice Lineare Varchar 100 SI Varchar 7 SI DataOra (aaaa-mmgg) DataOra (aaaa-mmgg) DataOra (aaaa-mmgg) 10 NO 10 NO 10 SI Varchar 5 SI Varchar 3 SI Varchar 3 SI Lista con separatore 10 NO Integer SI Varchar 10 SI Varchar 1 SI ES: Varchar 14 SI Descrizione Descrizione della prenotazione Varchar 255 NO 12

17 Prodotto ID Prodotto Raccomandata Smart 225 Raccomandata PRO 213 Tabella Prodotti Processo di accettazione Senza Materiale Affrancatura ID Processo SMA Tabella Processi di Accettazione Body Nome campo Descrizione Tipo Lunghezza Obbligatorio Codice Invio Nome e Cognome / Ragione Sociale destinatario Indirizzo destinatario Civico destinatario CAP destinatario Nel caso di codice lineare è necessario inserire anche il check digit. Nome e Cognome del destinatario dell invio, oppure, se Azienda, la ragione Sociale Indirizzo di destinazione dell invio Numero civico di destinazione dell invio Codice avviamento postale di destinazione dell invio Varchar 12 SI Varchar 100 SI Varchar 100 SI Varchar 5 NO Varchar 5 SI Città destinatario Città dell invio Varchar 50 SI Sigla Prov. Destinatario Sigla Prov. del destinatario Varchar 2 SI Codice Fiscale Codice Fiscale del Destinatario Varchar 18 NO Telefono destinatario* Numero di telefono del destinatario, necessario per notifica avvenuta consegna via sms. Varchar 20 NO Comprensivo del prefisso Internazionale destinatario* del destinatario Varchar 20 NO Valore Campo numerico che contiene il valore assicurato. Integer 5 NO Importo Contrassegno Campo numerico che contiene l importo del contrassegno. Integer 5 NO 13

18 Nome campo Descrizione Tipo Lunghezza Obbligatorio Codice AR Campo numerico che contiene il codice dell avviso di ricevimento dell invio (quando lo stesso Integer 12 NO è previsto) nel formato previsto per Assicurate / Raccomandate. Partita IVA Partita IVA del destinatario Varchar 13 NO Servizio Contrassegno Varchar 2 NO Ricevuta di ritorno Varchar 2 NO Esente AR Varchar 2 NO Assicurazione casi forza maggiore Varchar 2 NO Servizio Ritiro Digitale Se valorizzato a SI deve essere obbligatoriamente valorizzato il campo Codice Fiscale. Varchar 2 NO Destinazione tariffaria Varchar 30 NO Peso Float 5,2 NO Importo Unitario Float 5,2 NO Codice Omologazione ID Cliente Mittente Identificativo del Codice di Omologazione, assegnato da PI nella fase di omologazione del prodotto. Es. DCOPI0373 Codice identificativo della tripletta Varchar 9 SI Varchar 3 NO Formato Valori ammessi: P, M o G. Varchar 1 NO ID HU Codice Kanban del bancale Varchar 26 SI ID scatola Codice della scatola Varchar 20 SI ID utenza cliente Campo a disposizione del Cliente per individuare l identificativo dei suoi Varchar 50 NO clienti interni Numero fattura Campo a disposizione del Cliente fatturatore per individuare l eventuale identificativo della fattura inserita nell invio Varchar 50 NO Data scadenza fattura Spare_1 Spare_2 Data di scadenza della fattura Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Data (DDMMAAAA) 12 NO Varchar 255 NO Varchar 255 NO 14

19 Nome campo Descrizione Tipo Lunghezza Obbligatorio Spare_3 Spare_4 Spare_5 Spare_6 Spare_7 Spare_8 Spare_9 Spare_10 Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Varchar 255 NO Varchar 255 NO Varchar 255 NO Varchar 255 NO Varchar 255 NO Varchar 255 NO Varchar 255 NO Varchar 255 NO * I campi Telefono e , anche se valorizzati, non verranno presi in considerazione si fini dell erogazione del servizio Ritiro Digitale (varranno le informazioni legate all Identità Digitale PosteID). 4.4 Possibili errore comunicati in fase di validazione distinta I controlli sono previsti a livello di header e body. 15

20 4.4.1 Controlli sui campi dell Header Di seguito la lista dei controlli sintattici e semantici previsti in generale sui campi header della Distinta di Prenotazione: 1. Controlli sul Codice SAP Cliente inserito in distinta: a. Il Codice SAP Cliente deve appartenere ad un Cliente esistente in anagrafica; b. Il Codice SAP Cliente deve avere mappato il Prodotto inserito in distinta; c. Il Codice SAP Cliente deve avere mappato il Centro di Accettazione inserito in distinta; d. Il Codice SAP Cliente deve essere associato all utente prenotatore con una relazione di service; 2. Il codice ID Prenotazione deve essere stato scaricato dall utente prenotatore e non deve essere stato utilizzato in precedenti prenotazioni; 3. La data di spedizione deve essere maggiore o uguale della data di sistema e non inferiore rispetto agli SLA di prenotazione impostati per prodotto. La data di postalizzazione non dovrà essere nè di domenica, nè di festivo. Per giorni festivi si intendono solo le festività nazionali e le feste patronali. Qualora il sistema riscontrasse degli errori sull header bloccherà l intera prenotazione, inviando una notifica al cliente con gli errori riscontrati. 16

21 4.4.2 Controlli sui campi del Body Di seguito la lista dei controlli sintattici e semantici previsti in generale sui campi della Distinta Analitica di Prenotazione: Nome campo Descrizione Tipo Lunghezza Controlli Semantici Controlli Sintattici Codice Oggetto Nome e Cognome / Ragione Sociale destinatario Indirizzo destinatario Civico destinatario CAP destinatario Città destinatario Sigla Prov. Destinatario Codice Fiscale Telefono destinatario Nel caso di codice lineare vanno inseriti all inizio 60 zeri e il codice lineare va inserito con il check digit. Nome e Cognome del destinatario dell invio, oppure, se Azienda, la ragione Sociale Indirizzo di destinazione dell invio Numero civico di destinazione dell invio Codice avviamento postale di destinazione dell invio Varchar 72 Varchar 100 Varchar 100 Varchar 5 Varchar 5 Città dell invio Varchar 50 Sigla Prov. del destinatario Codice Fiscale del Destinatario Numero di telefono del destinatario, necessario per notifica avvenuta consegna via sms. Comprensivo del prefisso Internazionale Varchar 2 Varchar 18 Varchar 20 Verifica correttezza codice oggetto di posta descritta (check-digit) Deve esserne verificata l esistenza Deve far parte degli identificativi provincia censiti Nel caso di Servizio Inesitate Digitali il campo deve essere valorizzato Deve essere esattamente di 5 caratteri Deve essere esattamente di 2 caratteri Verrà controllata la corretta composizione del codice come alternanza tra caratteri alfabetici e numerici e verificato il codice Belfiore 17

22 Nome campo Descrizione Tipo Lunghezza Controlli Semantici Controlli Sintattici destinatario Valore Importo Contrassegno Codice AR Partita IVA Servizio Contrassegno del destinatario Campo numerico che contiene il valore assicurato Campo numerico che contiene il valore assicurato Campo numerico che contiene il codice dell avviso di ricevimento dell invio (quando lo stesso è previsto) nel formato previsto per Assicurate / Raccomandate Partita IVA del destinatario Può assumere i valori si/no Varchar 20 Integer Integer Integer 12 Varchar 13 Varchar 2 Verifica composizione mail: Verifica correttezza codice oggetto di posta descritta (check-digit) per il prodotto Raccomandata 1 con Prova di Consegna Nel caso in cui tale campo sia contrassegnato dal valore True deve essere controllato che il campo Importo Contrassegno sia valorizzato per il prodotto Raccomandata 1 in contrassegno Segnaliamo il warning, in caso di mancata valorizzazione a SI, in ogni caso valorizzarlo a TRUE nell invio al T&T ma non viene valorizzato l importo (Euro)Non inferiore a 0.05Euro e non superiore a 1000Euro (Euro) Non inferiore a 0,05Euro e non superiore a 3000Euro In caso di Raccomandata 1 in Contrassegno (RC) tale dato non deve essere inserito nonostante il cliente abbia attivo il Servizio di Contrassegno 18

23 Nome campo Descrizione Tipo Lunghezza Controlli Semantici Controlli Sintattici Ricevuta di ritorno Esente AR Assicurazione case forza maggiore Servizio Inesitate Digitali Destinazione tariffaria Peso Importo Unitario Codice Omologazione Può assumere i valori si/no Può assumere i valori si/no Può assumere i valori si/no Può assumere i valori si/no Il campo dovrà assumere il valore Italia Peso espresso in gr Identificativo del Codice di Omologazione, assegnato da PI nella fase di omologazione del prodotto. Es. DCOPI0373 Varchar 2 Varchar 2 Varchar 2 Varchar 2 Varchar 30 Float 5,2 Float 5,2 Varchar 9 Nel caso in cui tale campo sia contrassegnato dal valore True per il prodotto Raccomandata 1 in Contrassegno (RC) deve essere controllato che il campo Codice Avviso di Ricevimento sia valorizzato Per i prodotto Atto Giudiziario e Raccomandata 1 con Prova di Consegna Se non viene valorizzato a true Segnaliamo il warning, in ogni caso valorizzarlo a TRUE verso il T&T; in ottica Inesitate Digitali tale campo dovrà essere valorizzato TRUE\FALSE anche per gli oggetti di Posta Registrata che prevedono un AR\AC di classe non registrata. Nel caso di posta registrata deve essere omogeneo. Pena lo scarto della distinta dal sistema Deve essere verificato che il valore contenuto all interno del campo sia True o False 19

24 Nome campo Descrizione Tipo Lunghezza Controlli Semantici Controlli Sintattici IDCliente Mittente Formato ID HU ID scatola ID utenza cliente Numero fattura Data scadenza fattura Spare_1 Spare_2 Spare_3 Spare_4 Spare_5 Identificativo del Codice di Omologazione, assegnato da PI nella fase di omologazione del prodotto. Es. DCOPI0373 Per la posta registrata i formati ammessi saranno: Standard e Non Standard Codice\Kanban del bancale Codice della scatola Campo a disposizione del Cliente per individuare l identificativo dei suoi clienti interni Campo a disposizione del Cliente fatturatore per individuare l eventuale identificativo della fattura inserita nell invio Data di scadenza della fattura Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Varchar 3 Varchar 1 Varchar 26 Varchar 20 Varchar 50 Varchar 50 Data (DDMMAAAA) 12 Varchar 255 Varchar 255 Varchar 255 Varchar 255 Varchar 255 Dato non obbligatorio nel caso di Posta Registrata. Tuttavia in caso di mancato inserimento sarà sollevato warning Dato non obbligatorio nel caso di Posta Registrata. Tuttavia in caso di mancato inserimento sarà sollevato warning 20

25 Nome campo Descrizione Tipo Lunghezza Controlli Semantici Controlli Sintattici Spare_6 Spare_7 Spare_8 Spare_9 Spare_10 Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Campo facoltativo ad uso del cliente Varchar 255 Varchar 255 Varchar 255 Varchar 255 Varchar Comunicazione esito della validazione della Distinta di Prenotazione Nel caso di caricamento della Distinta Analitica di Postalizzazione mediante Canale SFTP oppure WebService verrà restituito al Cliente l esito mediante un file in formato CSV che potrà essere: In caso di Esito OK: NPSO_Esito_Prenotazione_OK_[id_prenotazione] In caso di Esito KO: NPSO_Esito_Prenotazione_KO_[id_prenotazione] 21 Il file di Esito OK potrà comunque notificare al Cliente eventuali anomalie non bloccanti la lavorazione (a differenza dell Esito KO), potrà essere accompagnato da due ulteriori file CSV: File BAD: Il file BAD rappresenta un file, (formato CSV, messo a diposizione del cliente mediante il canale FTP/Mail, contenente il dettaglio relativo alle righe viziate da errori e l indicazione degli errori riscontrati. File Righe Scartate: Tale file viene prodotto, e condiviso con il cliente mediante Mail/FTP, quando esistono all interno della prenotazione righe scartate per problemi strutturali (numero colonne errate/campi troppo lunghi). Tutti i CSV avranno le seguenti caratteristiche tecniche: Separatore Campi: Separatore Record: CRLF Quote: Codifica: UTF-8 Il dettaglio dei Codici di Errore è riportato nell Appendice Dettaglio Errori PsOnline (Paragrafo 8).

26 Tracciato File CSV Esito Prenotazione OK Nomenclatura NPSO_Esito_Prenotazione_OK_[id_prenotazione] Header Modalità di Affrancatura Ragione Sociale Cliente Partita IVA Codice Cliente (ID SAP r/3) N Conto Contrattuale Indirizzo Prodotto ID Prenotazione Long Centro Accettazione (codice AGE) Data Formato dd/mm/yyyy (es. 22/12/2016) Ora Formato HH:mm:ss (es 18:53:48) Nome File Distinta Esito Caricamento Body (valorizzato solo in caso di errori sugli invii) Codice Errore Errore Riscontrato Numero di Invii Integer Codice Azione Azioni 22

27 Tracciato File CSV Bad Analitica OK Nomenclatura NPSO_Bad_Analitica_[id_prenotazione-progressivo].csv Body Codice Invio Codice AR Destinatario Indirizzo Civico Città CAP Provincia Codice Fiscale Partita IVA Telefono Importo Contrassegno Valore Assicurata Servizio di Contrassegno Servizio Avviso di Ricevimento Atto Esente Assicurazione Contro Rischi di Forza Maggiore Formato Destinazione Tariffaria Peso Importo Unitario Spare 1 Spare 2 Spare 3 Spare 4 Spare 5 Spare 6 Spare 7 Spare 8 Spare 9 Spare 10 Codice Omologazione Codice 3C Codice Pallet Codice Scatola Codice Utenza Operatore Float Float Boolean (Y N) Boolean (Y N) Boolean (Y N) Boolean (Y N) 23

28 Numero Fattura Data Scadenza Fattura Servizio Inesitate Digitali Codice_Errore Descrizione Boolean (Y N) Tracciato File CSV Righe Scartate OK Nomenclatura NPSO_Righe_Scartate_[id_prenotazione-progressivo].csv Body Quantità CAP Indirizzo Provincia Codice Pallet Formato Codice 3C Codice errore Descrizione Tracciato File CSV Esito Prenotazione KO Nomenclatura NPSO_Esito_Prenotazione_KO_[id_prenotazione-progressivo].csv Header Modalità di Affrancatura Ragione Sociale Cliente Partita IVA Codice Cliente (ID SAP r/3) N Conto Contrattuale Indirizzo Prodotto ID Prenotazione Long Centro Accettazione (codice AGE) Data Formato dd/mm/yyyy (es. 22/12/2016) Ora Formato HH:mm:ss (es 18:53:48) Nome File Distinta Esito Caricamento

29 Body (valorizzato solo in caso di errori sugli invii) Il caso File Illeggibile sarà segnalato tramite opportuno codice di errore Codice Errore ERRXX Errore Riscontrato File Illeggibile Numero di Invii - Codice Azione AZI00 Azione Ricaricare il file Il caso Errore su header sarà segnalato tramite opportuno codice di errore Codice Errore ERRXX Errore Riscontrato Errore su header Numero di Invii - Codice Azione AZI00 Azione Ricaricare il file 4.5 Upload Distinta Analitica di Prenotazione via SFTP In alternativa al caricamento della Distinta Analitica di Prenotazione è possibile richiedere l attivazione di cartelle di scambio SFTP. Per l attivazione della cartella è necessario far riferimento al referente commerciale che effettua una verifica di fattibilità. In particolare. Eventuali cause tecniche, che non consentano l attivazione della cartella, saranno prontamente comunicate al Cliente Upload Distinta Analitica di Prenotazione via Web Service In alternativa al caricamento della Distinta Analitica di Prenotazione è possibile richiedere l attivazione di un canale di scambio Web Service.

30 Per l attivazione della canale Web Service è necessario far riferimento al referente commerciale che effettua una verifica di fattibilità. Eventuali cause tecniche, che non consentano l attivazione del canale, saranno prontamente comunicate al Cliente. Il sistema PSOnline metterà a disposizione un interfaccia REST per Consentire l upload di una Distinta Analitica di Prenotazione inviata via Web Service Consentire il download delle notifiche a valle del processamento della distinta Diagramma generale: Salva il file distinta su File System Avvia in modo asincrono processo BPEL di caricamento distinta OK Distinta HTTP REST POST UPLOAD Customerusercode customercode Check user permission KO ERROR: BaseFaultType OK Check nome file KO ERROR: BaseFaultType 202 OK Processo InsertGU / InsertPostaEasy MESSAGE DELIVERY Destination = «TraceDestination» Invia notifiche sull esito del caricamento della distinta 26 Memorizza su DB tutte le informazioni necessarie a produrre le notifiche su file bookingid, bookingse Messaggio di notifica HTTP REST GET OK GET NOTIFICATIONS 200 Content: lista di MessageType Customerusercode customercode Check user permission Interfaccia Figura 1. Diagramma generale Il sistema espone il servizio inesitate Endpoint <base URI>/inesitate Le operazioni sono descritte di seguito.

31 Richiesta ID Prenotazione ID Questo servizio consente ad un operatore di richiedere un numero (definito dall operatore stesso) di ID Prenotazione che il Cliente\Service potrà utilizzare successivamente all interno (header) delle Distinte Analitiche di Prenotazione. Gli ID Prenotazione apparterranno ad un range compreso tra e Una volta richiesti gli ID Prenotazione questi vengono restituiti nella response nonché inviati via mail all indirizzo configurato sull operatore inserito come parametro. URL Metodo Parametri URL Parametri query string Request content Response (success) Response (error) Esempio { <base URI>/multipleIds?customerSapCode=[ ]&productid=[ ]&quantity [ ]&usercode=[ ] GET customersapcode = codice SAP SD del cliente (nella forma ) productid = Id del prodotto. Questo parmetro può essere nascosto al cliente ed essere valorizzato sempre con 65. quantity = numero di codici richiesti usercode = codice Postecom dell operatore (nella forma nome.cognome. azienda). Deve essere uguale al campo ClientId presente nel Context message: Ok severity : INFO / WARNING severity: SEVERE return : { 11T16:38: :00 resultstatus : [ { severity : INFO, code : null, message : Ok, timestamp : }, { severity : WARNING, code : null, message : Non è presente l indirizzo di posta elettronica per l utente vale.feli2.cps. Impossibile inviare , timestamp : T16:38: :00 } ], resultlist : [ , ] } } 27

32 Inserimento Distinta Analitica di Prenotazione Questo servizio consente il caricamento della Distinta Analitica di Prenotazione; la nomenclatura del file e la specifica tecnica (header e body) devono rispettare quanto riportato nel paragrafo 6.3 (Specifica Distinta Analitica di Prenotazione). URL /upload/{filename}?customercode=[ ]& customerusercode=[ ] Metodo POST Parametri URL filename = nome del file della distinta che si vuole caricare Parametri query string customercode = codice SAP SD del cliente (nella forma ) customerusercode = codice Postecom dell operatore (nella forma nome.cognome.azienda) Request content contenuto del file in Base64 Response (success) Code: 202 Response (error) Code: codice di errore (numerico) Content: BaseFaultType Recupero notifiche Questo servizio consente il recupero delle notifiche disponibili data la coppia bookingid bookingsequence; la specifica tecnica delle notfiche rispettare quanto riportato nel paragrafo (Comunicazione esito della validazione della Distinta di Prenotazione). 28

33 URL Metodo /getnotifications/{bookingid}/{bookingseq}?customercode= [ ]&customerusercode=[ ] GET Parametri URL bookingid = id prenotazione bookingseq = progressivo della prenotazione Parametri query string customercode = codice SAP SD del cliente (nella forma ) customerusercode = codice Postecom dell operatore (nella forma nome.cognome.azienda) Response (success) Code: 200 Content: lista di MessageType in formato XML o JSON Response (error) Code: codice di errore (numerico) Content: BaseFaultType Esempio [ { content :{ type : SearchTextMessageType, subject : Poste Italiane - Servizio Prenotazione PSOnline, attachment :[ { data :, filename : NPSO_Esito_Prenotazione_KO_ csv } ], metadata :[ { key : BOOKINGID, value :{ type : string, value : } } ], date : T16:11:01+01:00 }, destination :[ { type : TraceDestinationType, traceable :true, status : SENT, } ] } ] Componente Message Delivery Il sistema mette a disposizione una Destination (TraceDestination) per la componente di message delivery per notificare l esito del caricamento della distinta via WebService.

34 L interfaccia del message delivery espone il metodo sendmessages al quale vanno passati i seguenti parametri: Un messaggio che: Tra le destinazioni, ne avrà una di tipo TraceDestination. Nel contenuto (di tipo MessageContent) avrà, come allegati (parametro attachments), i file da scrivere Per la destination dovranno essere settati i seguenti parametri come metadata: bookingid bookingseq Dettagli del processo di acquisizione da eseguire Il processo da invocare è InsertGU al quale vanno passati i seguenti parametri nella richiesta: filezip = nome del file passato in input channeltype = BPI filetype = DU Parametri di contesto clientid sessionid traceabilityid operationid Modello del dominio Per i dettagli vedi lo schema XSD allegato MessageType Figura 2. MessageType

35 MessageContentType Figura 3. MessageContentType TextMessageContextType 31 Figura 4. TextMessageContentType SearchTextMessageType Figura 5. SearchTextMessageType

36 DestinationType DestinationType Figura 6. DestinationType FileDestinationType Figura 7. FileDestinationType

37 ScrDestinationType Figura 8. ScrDestinationType WebServiceDestinationType 33 Figura 9. WebServiceDestinationType

38 Base Fault Type Figura 10. BaseFaultType 34

39 5 UPLOAD FILE ARCHIVIO PDF 5.1 Informazioni preliminari In questo paragrafo viene definita la struttura dei flussi di Archiviazione che il Cliente, oppure il Service per conto del Cliente, dovrà affidare a Poste Italiane. 5.2 Struttura dei file in input La struttura dei file in input, gestiti dalla piattaforma di accettazione ed elaborazione dei flussi di Archiviazione Diretta, deve prevedere un file compresso con estensione.cpx (ZIP rinominato). NB: La dimensione massima dei file CPX inviati a Poste non deve superare i 250 Mb. 35 Nomenclatura: <CodiceSAPService>_<CodiceSAPCliente>_<YYYYMMDD>_ <Progressivo>.cpx dove: <CodiceSAPService> àid SAP (8 char) del Service che genera ed affida a PI i File PDF <CodiceSAPCliente> àid SAP (8 char) del Cliente Mittente dei File PDF <YYYYMMDD> à Anno mese e giorno dell invio del CPX <Progressivo> àprogressivo numerico di invio nella giornata NB: Il nome del file non può contenere spazi,., -, /; entrambi i file avranno il medesimo nome (corrispondente al nome lotto cliente) che deve essere univoco assoluto, vale a dire diverso per ogni invio. L archivio dovrà contenere: File degli indici 1. Estensione:.xml 2. Numerosità: uno per ogni CPX; in pratica ad ogni lotto corrisponde un file indici

40 3. Nomenclatura per la tipologia XML: nome lotto + _I (parte statica) Esempio: cliente_file042010_i.xml 4. Contenuto: riferimenti tra immagini (PDF) e chiavi utente 5. Struttura: vedi paragrafo 7.3 File informativo 1. Estensione:.inf 2. Numerosità: uno per ogni CPX; in pratica ad ogni lotto corrisponde un file informativo 3. Nomenclatura: nome lotto Esempio: cliente_file inf 4. Contenuto: informazioni generali del lotto 5. Struttura: vedi paragrafo 7.4 File Immagine 1. Estensione:.PDF 2. Numerosità: 1 o più file; ad esempio un lotto di 100 indirizzi deve contenere 100 file immagine. 3. Nomenclatura: nome lotto + progressivo di 6 char (qualora nell archivio ci fossero più file) 36 Esempio: (se è presente un solo file) cliente_file pdf Esempio: (se sono presenti 2 file) cliente_file042010_ pdf cliente_file042010_ pdf 5.3 Struttura del file indici di tipologia XML Le informazioni presenti nel file XML delle chiavi sono classificate in 3 sezioni: Intestazione del file XML Di seguito le specifiche di inizializzazione del file degli indici che dovrà assumere i seguenti valori. <?xml version= 1.0 encoding= utf-8?>

41 5.3.2 Sezione di dichiarazione delle chiavi E presente una sola volta immediatamente dopo la precedente sezione di informazioni e dovrà assumerere i seguenti valori. <Index_declaration> <Index_declaration> <Idx_name id= i101 type= user fmt= string >codicefiscalemittente</idx_name> <Idx_name id= i102 type= user fmt= string >codicefiscaledestinatario</idx_name> <Idx_name id= i103 type= user fmt= number >ServizioAR</Idx_name> <Idx_name id= i104 type= user fmt= string >Stato</Idx_name> <Idx_name id= i105 type= user fmt= date >DataEsito</Idx_name> <Idx_name id= i106 type= user fmt= date >DataInesito</Idx_name> <Idx_name id= i107 type= user fmt= string >Note</Idx_name> <Idx_name id= i108 type= user fmt= string >TipologiaAR</Idx_name> <Idx_name id= i109 type= user fmt= string >NominativoAR</Idx_name> <Idx_name id= i110 type= user fmt= string >MittenteAR</Idx_name> <Idx_name id= i111 type= user fmt= string >IndirizzoAR</Idx_name> <Idx_name id= i112 type= user fmt= string >CAPAR</Idx_name> <Idx_name id= i113 type= user fmt= string >ProvinciaAR</Idx_name> <Idx_name id= i114 type= user fmt= string >CittaAR</Idx_name> <Idx_name id= i115 type= user fmt= string >codiceinvio</idx_name> <Idx_name id= i116 type= user fmt= string >esitoarchiviazione</idx_name> <Idx_name id= i117 type= user fmt= string >alertdimensionefile</idx_name> <Idx_name id= i118 type= user fmt= string >datadigitalizzazione</idx_name> <Idx_name id= i119 type= user fmt= string >IdTecnico</Idx_name> <Idx_name id= i120 type= user fmt= string >AR</Idx_name> <Idx_name id= i121 type= user fmt= string >ComplNominativoMittente</Idx_name> <Idx_name id= i122 type= user fmt= string >ComplIndirizzoMittente</Idx_name> <Idx_name id= i123 type= user fmt= string >ComplNominativoDestinatario</Idx_name> <Idx_name id= i124 type= user fmt= string >ComplIndirizzoDestinatario</Idx_name> <Idx_name id= i125 type= user fmt= string >NomeProdottoCommerciale</Idx_name> <Idx_name id= i100 type= system fmt= number >Codice Raccomandata</Idx_name> </Index_declaration> 37

42 5.3.3 Sezione di valorizzazione delle chiavi E presente in rapporto 1 a 1 rispetto ai file PDF contenuti nell archivio. Ovviamente i valori cambieranno, a seconda dell invio, di seguito un esempio di valorizzazione: - <Letter_section Num_pages= 2 > - <Info_section> <Info name= File_name >cliente_file042010_ pdf</info> </Info_section> - <Index_value> <Idx ref= i101 >PRCDTC73E14H591F</Idx> <Idx ref= i102 >CLGCSRA66P52U501B</Idx> <Idx ref= i103 >0</Idx> <Idx ref= i104 /> <Idx ref= i105 /> <Idx ref= i106 /> <Idx ref= i107 > </Idx> <Idx ref= i108 /> <Idx ref= i109 >Nome Test</Idx> <Idx ref= i110 >PRCDTC73E14H591F</Idx> <Idx ref= i111 >Viale Europa, 175</Idx> <Idx ref= i112 >00144</Idx> <Idx ref= i113 >RM</Idx> <Idx ref= i114 >Roma</Idx> <Idx ref= i115 /> <Idx ref= i116 /> <Idx ref= i117 /> <Idx ref= i118 /> <Idx ref= i119 > </Idx> <Idx ref= i120 /> <Idx ref= i121 >PCL/MKTG</Idx> <Idx ref= i122 >stanza D222</Idx> <Idx ref= i123 /> <Idx ref= i124 /> <Idx ref= i125 >Posta Raccomandata Pro</Idx> <Idx ref= i100 > </Idx> </Index_value> </Letter_section> 38

43 Regole per la valorizzazione dei campi: Campo Valorizzazione Statica Obbligatorio ServizioAR Num_pages Info name - 0 senza AR - 1 con AR Numero delle pagine che compongono il singolo file immagine Nome del file immagine comprensivo di estensione Idx ref Valore effettivo dell indice No Note ID SAP a 10 caratteri del Cliente Mittente delle Raccomandate Digita ovvero dei File PDF No No No No Si Si Si No (ad esclusione della i100 e i119) SI NOTE IMPORTANTI: il valore della chiave i100 (codice raccomandata) è utilizzato come chiave univoca di caricamento, per cui qualora dovesse presentarsi un certo valore in invii diversi, i successivi verrebbero scartati (a livello di singolo documento e non di flusso CPX). I campi i109, i110, i111, i112, i113 e i114 devono essere compilati anche se ServizioAR = 0 Il valore della chiave i119 (id_tecnico) deve essere obbligatoriamente lo stesso della chiave i Sezione di riepilogo delle informazioni E presente una sola volta in fondo al file XML. Esempio di sezione: <Info_prn_file> <Customer_id>Z </Customer_id> <Num_letters>2</Num_letters> <Num_pages>2</Num_pages> </Info_prn_file> </Prn_files_info> Di seguito le regole di valorizzazione dei campi: Campo Valorizzazione Statica Obbligatorio Customer_id Fisso a Z SI Si Num_letters Numero totale dei documenti No Si Num_pages Numero totale delle pagine di tutti i documenti No Si

44 5.4 Struttura del file.inf File di Informazioni generali Il file di Informazioni generali racchiude tutte le informazioni relative alla spedizione. Per ogni spedizione deve essere creato un unico file di Informazioni generali, che costituirà insieme ai file immagine ed al file indici, il contenuto della spedizione stessa. Il file viene creato in formato ASCII con diverse sezioni, sul modello dei file.ini. I parametri stabiliti dovranno essere presenti anche se vuoti. Il nome del file di informazioni deve essere composto da: Nomelotto.inf Sezione Info Job Esempio di sezione: [info_job] Id_utente=Zid del cliente abilitato al servizio (es. Z ) Data_inoltro=01/05/2017 Nome_lotto=cliente_file Numero_documenti=2 Numero_pagine=4 40 La sezione Info Job contiene le informazioni sul cliente e sul numero di documenti generati per l archiviazione. Campo Valorizzazione Statica Obbligatorio Id_utente Identificativo (Z) dell utente No SI Data_inoltro Data di invio No Si Nome_lotto Nome del lotto inviato No Si Numero_ Numero dei documenti complessivi del lotto No Si documenti Numero_pagine Numero delle pagine complessive del lotto Si Si

45 5.4.3 Sezione Info archive Esempio di sezione: [info_archive] servizio=web Nome_procedura=PI_IN_DIG La sezione Info_Archive contiene le informazioni relative alla procedura di archiviazione, ed al tipo di lavorazione prescelta (servizio): Campo Valorizzazione Statica Obbligatorio Servizio Servizio richiesto a Postel che nel caso di No SI Inesitate Digitali sarà valorizzato a: - WEB Nome_procedura Nome della procedura che nel caso di Inesitate Digitali sarà valorizzato a: - PI_IN_DIG No Si Esempio di file inf [info_job] Id_utente=Z Data_inoltro=01/05/2017 Nome_lotto=cliente_file Numero_documenti=2 Numero_pagine=4 41 [info_archive] servizio=web Nome_procedura=PI_IN_DIG 5.5 Ricevute di accettazione flussi.cpx A fronte dell invio dei file CPX da parte dello speditore, il sistema di accettazione Poste depositerà nell area FTP condivisa denominata Ricevute 2 tipologie di file riconoscibili come estensione del file di ricevuta: J00 (esito positivo) E00 (esito negativo)

46 I file spediti dallo stampatore, attraverso i canali di trasmissione disponibili, in fase di accettazione vengono definiti FLUSSI mentre il CODICE MIDA è il nome che la piattaforma di accettazione assegna univocamente ai flussi Esempio di ricevuta di Presa in carico del Flusso con esito Positivo (J00) NOME: CODICE MIDA-NOMEFLUSSO.J00 ESEMPIO: RF BA _ _ _001.J00 <?xml version= 1.0 encoding= UTF-8 standalone= no?> <Flow Id= RF BA Size= isdir= false > <CustomerIdSender>Z </CustomerIdSender> <UserId> </UserId> <ReceiptDate> T15:22:16</ReceiptDate> <Name> _ _ _001</Name> <Status>RICEVUTO</Status> <InputSystem Channel= Ftp SiteId= RMFTP /> <Files FileNum= 2 > <File Name= _ _ _001.ASC Size= /> <File Name= _ _ _001.T Size= 0 /> </Files> </Flow> 42

47 5.5.2 Esempio di ricevuta di Presa in carico del Flusso con esito Negativo (E00) NOME: CODICE MIDA-NOMEFLUSSO.E00 NB: il CODICE MIDA potrebbe non essere presente nel caso in cui il flusso viene scartato preliminarmente come nel caso a seguire ESEMPIO: RF BA _ _ _001.E00 Esempio di errore: caratteri non consentiti nel nome del file <?xml version= 1.0 encoding= UTF-8 standalone= no?> <Flow Id= RF D2 Size= isdir= false > <CustomerIdSender> Z </CustomerIdSender> <UserId> </UserId> <ReceiptDate> T18:08:49</ReceiptDate> <Name>BP2AGPK-K</Name> <Status>RIFIUTATO - caratteri non consentiti nel nome</status> <InputSystem Channel= Ftp SiteId= RMFTP /> <Files FileNum= 2 > <File Name= _ _ _001.ASC Size= /> <File Name= _ _ _001.T Size= 0 /> </Files> Ricevute di completamento caricamento su Documentale Successivamente alla ricezione dei flussi su sistema di accettazione UDH, queste vengono prese in carico dal sistema di caricamento su piattaforma documentale Poste. Al termine di questa operazione viene generata una ricevuta (una per ciascun CPX) e depositate nell area Ricevuta di cui sopra.

48 NOME: CODICE MIDA-NOMEFLUSSO.ARC ESEMPIO: _ _ _001.ARC Di seguito il formato della Ricevuta di avvenuto caricamento. <?xml version= 1.0?> <DeliverySet Id= codice lotto 11 char LotsNum= 1 > <Lot Name= nome del lotto cliente Id= codice lotto 14 char Application= procedura di archiviazione > <AcceptDate> data arrivo flussi in ambito documentale </AcceptDate> <CustomerIdSender>Zid</CustomerIdSender> <CustomerIdBilling>Zid</CustomerIdBilling> <UserId>User Id dello speditore</userid> <Service> <Print> <LotType> <Sending>formato dei documenti</sending> <Delivery>delivery di archiviazione</delivery> </LotType> <Status Id= stato di chiusura lotto archiviazione Date= data chiusura lotto aaaa-mm-ggthh:mm:ss >descrizione dello stato</status> <PagesNum>numero pagine</pagesnum> <SheetNum>numero fogli</sheetnum> <TotalAddressesNum>numero documenti</totaladdressesnum> <SubLotNum>numero sottolotti</sublotnum> </Print> </Service> </Lot> </DeliverySet> 44

49 Campo su XML Presenza obbligatoria Descrizione DeliverySet Id SI Codice mida LotsNum SI Statico 1 Lot Name SI Flusso CPX inviato dallo stampatore Application SI Statico PI_IN_DIG AcceptDate SI Data arrivo su documentale (pre-caricamento) CustomerIdSender SI Statico CustomerIdBilling SI Statico UserId SI Statico Sending SI Formato dei file inviati dallo stampatore (ad esempio PDF) Delivery SI Servizio richiesto; statico WEB Status Id SI 40 (lotto caricato con successo) Date SI Data caricamento su documentale PagesNum SI Numero pagine totale dei documenti presenti nel CPX SheetNum SI Numero pagine totale dei documenti presenti nel CPX TotalAddressesNum SI Numero dei documenti totali dei documenti presenti nel CPX SubLotNum SI Statico Upload File Archivio PDF via Web Service 45 Il web service di Upload dei File PDF permette la ricezione di gruppi di file; ogni transazione corrisponde ad una unica spedizione, ovvero ad ogni richiesta di invio, il sistema assegnerà un identificativo univoco di spedizione. Occorre autenticarsi al sistema tramite l inserimento delle credenziali d accesso fornite da Poste Italiane al Cliente, ovvero Username (UserID) e Password. Se il cliente invia due file o più file, questi devono avere lo stesso nome file originale a meno della estensione che deve variare. In caso contrario il flusso verrà rifiutato e comunicata al cliente la motivazione del rifiuto (il nome file deve rispettare le specifiche standard ovvero contenere esclusivamente lettere, numeri e come unico carattere special, l underscore _ ).

50 La dimensione massima di ogni file è 5 MB. Il sistema a seguito della ricezione dei file inoltra una di conferma, sia essa di esito positivo che negativo; l indirizzo di destinazione (può essere più di uno) sarà dichiarato all interno dei parametri scambiati alla attivazione del web service. In caso tale parametro sia assente, il flusso non sarà accettato. Il testo della riporterà in modalità discorsiva i dettagli della spedizione; le stesse informazioni saranno riportate nell allegato della in una struttura xml; di seguito alcuni esempi illustrativi dell allegato. Esempio di ricevuta positiva: <?xml version= 1.0 encoding= UTF-8 standalone= no?> <Flow Id= RW710026F22 Size= isdir= false > <CustomerIdSender>Z </CustomerIdSender> <UserId> </UserId> <ReceiptDate> T15:11:22</ReceiptDate> <Name> SPEDIZIONE1</Name> <Status>RICEVUTO</Status> <InputSystem Channel= Ftp SiteId= RMFTP /> <Files FileNum= 3 > <File Name= SPEDIZIONE1.XML Size= 1024 /> <File Name= SPEDIZIONE1.ZIP Size= /> <File Name= SPEDIZIONE1.T Size= 0 /> </Files> </Flow> 46

51 Esempi di ricevuta negative: <?xml version= 1.0 encoding= UTF-8 standalone= no?> <Flow Id= RW710026F22 Size= isdir= false > <CustomerIdSender>Z </CustomerIdSender> <UserId> </UserId> <ReceiptDate> T15:11:22</ReceiptDate> <Name> SPEDIZIONE-1</Name> <Status>RIFIUTATO - caratteri non consentiti nel nome</status> <InputSystem Channel= Ftp SiteId= RMFTP /> <Files FileNum= 3 > <File Name= SPEDIZIONE-1.XML Size= 1024 /> <File Name= SPEDIZIONE-1.ZIP Size= /> <File Name= SPEDIZIONE-1.T Size= 0 /> </Files> </Flow> <?xml version= 1.0 encoding= UTF-8 standalone= no?> <Flow Id= RW710026F22 Size= 0 isdir= false > <CustomerIdSender>Z </CustomerIdSender> <UserId> </UserId> <ReceiptDate> T15:11:22</ReceiptDate> <Name> SPEDIZIONE-1</Name> <Status>RIFIUTATO - ricezione del solo file di trailer </Status> <InputSystem Channel= Ftp SiteId= RMFTP /> <Files FileNum= 1 > <File Name= SPEDIZIONE1.T Size= 0 /> </Files> </Flow> Metodi esposti In questo paragrafo vengono elencati e descritti i metodi esposti del WBS, la struttura dati, un esempio di chiamata e il risultato ottenuto.

52 Metodo SendRequest Il metodo esposto sul WS di Gestione Invio è: sendrequest(mtomfilebean[] mtomfilebeans, [] addresses) e come ritorno ha un parametro di tipo stringa Parametri di input MtomFileBean addresses Strutture oggetto Base64Binary data filename array che rappresenta i files inviati nella richiesta array degli indirizzi a cui saranno inviate le notifiche Contenuto del file inviato Nome del file inviato Esempio di chiamata Segue un esempio completo di chiamata al WS. SendingManagerStub stub = new SendingManagerStub( services/sendingmanager.sendingmanagerhttpsoap11endpoint/ ); 48 stub._getserviceclient().getoptions().setproperty(constants.configuration.enable_ MTOM, Constants.VALUE_TRUE);//protocollo MTOM abilitato stub._getserviceclient().getoptions().setproperty(constants.configuration.enable_ MTOM, Constants.VALUE_FALSE);//protocollo MTOM disabilitato stub._getserviceclient().getoptions().settimeoutinmilliseconds(60000); Options opt = stub._getserviceclient().getoptions(); Authenticator authenticator = new Authenticator(); List<> auth = new ArrayList<>(); auth.add(authenticator.basic); authenticator.setauthschemes(auth); authenticator.setusername( usr ); authenticator.setpassword( pwd ); authenticator.setpreemptiveauthentication(true); opt.setproperty(httpconstants.authenticate, authenticator); SendRequest request = new SendRequest(); File file = new File( C:/aaa.txt );

53 MtomFileBean mtomfilebean = new MtomFileBean(); Base64Binary base64binary = new Base64Binary(); FileDataSource filedatasource = new FileDataSource(file); DataHandler datahandler = new DataHandler(fileDataSource); base64binary.setbase64binary(datahandler); mtomfilebean.setdata(base64binary); mtomfilebean.setfilename( aaa.txt ); request.setmtomfilebeans(new MtomFileBean[]{mtomFileBean, 2}); request.set addresses(new []{ @ .com }); SendRequestResponse response = stub.sendrequest(request); System.out.println( response : +response.get_return()); Ritorno del modello Dopo aver richiamato il metodo sopra descritto, si possono ottenere le seguenti risposte: OK - <FLOW_ID> RIFIUTATO - <desc_errore> Nel primo caso, per esito positivo, la stringa ritornata conterrà il valore OK. 49 Nel secondo caso, per esito negativo, la stringa ritornata conterrà il valore RI- FIUTATO e seguirà una breve descrizione della motivazione dell esito negativo Descrizione degli errori Gli errori sono stati divisi in due categorie, errori di validazione ed eventuali errori applicativi. Questi errori saranno poi memorizzati nella tabella SEND_FLOW_ERROR. ERRORI DI VALIDAZIONE ( legati ai dati in input, necessari per poter comporre il nome file da depositare nel File System) Caratteri non consentiti nel nome Nomi file non corrispondenti Zeta Cliente non valido Nessun indirizzo specificato ERRORI APPLICATIVI (dovuti a problemi applicativi o di sistema) Errore Generico, contattare il supporto coscienza

54 5.7.2 WSDL <wsdl:definitions xmlns:wsdl= xmlns:ns1= apache.axis2/xsd xmlns:ns= xmlns:wsaw= w3.org/2006/05/addressing/wsdl xmlns:http= xmlns:ax21= xmlns:ax22= types.databinding.axis2.apache.org/xsd xmlns:xs= xmlns:mime= xmlns:soap= xmlsoap.org/wsdl/soap/ xmlns:soap12= targetnamespace= > <wsdl:documentation>please Type your service description here</wsdl:documentation> <wsdl:types> <xs:schema attributeformdefault= qualified elementformdefault= qualified targetnamespace= > <xs:complextype name= Base64Binary > <xs:sequence> <xs:element minoccurs= 0 name= base64binary nillable= true type= xs:base64binary /> </xs:sequence> </xs:complextype> </xs:schema> <xs:schema xmlns:ax23= attribute- FormDefault= qualified elementformdefault= qualified targetnamespace= common.sending.service.altran.com/xsd > <xs:import namespace= /> <xs:complextype name= MtomFileBean > <xs:sequence> <xs:element minoccurs= 0 name= data nillable= true type= ax23:base64binary /> <xs:element minoccurs= 0 name= filename nillable= true type= xs:string /> </xs:sequence> </xs:complextype> </xs:schema> <xs:schema xmlns:ax24= attribute- FormDefault= qualified elementformdefault= qualified targetnamespace= > <xs:import namespace= /> <xs:element name= sendrequest > <xs:complextype> <xs:sequence> <xs:element maxoccurs= unbounded minoccurs= 0 name= mtomfilebeans nillable= true type= ax24:mtomfilebean /> <xs:element maxoccurs= unbounded minoccurs= 0 name= addresses nillable= true type= xs:string /> </xs:sequence> </xs:complextype> 50

55 </xs:element> <xs:element name= sendrequestresponse > <xs:complextype> <xs:sequence> <xs:element minoccurs= 0 name= return nillable= true type= xs:string /> </xs:sequence> </xs:complextype> </xs:element> </xs:schema> </wsdl:types> <wsdl:message name= sendrequestrequest > <wsdl:part name= parameters element= ns:sendrequest /> </wsdl:message> <wsdl:message name= sendrequestresponse > <wsdl:part name= parameters element= ns:sendrequestresponse /> </wsdl:message> <wsdl:porttype name= SendingManagerPortType > <wsdl:operation name= sendrequest > <wsdl:input message= ns:sendrequestrequest wsaw:action= urn:sendrequest /> <wsdl:output message= ns:sendrequestresponse wsaw:action= urn:sendrequestresponse /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name= SendingManagerSoap11Binding type= ns:sendingmanagerport- Type > <soap:binding transport= style= document /> <wsdl:operation name= sendrequest > <soap:operation soapaction= urn:sendrequest style= document /> <wsdl:input> <soap:body use= literal /> </wsdl:input> <wsdl:output> <soap:body use= literal /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:binding name= SendingManagerSoap12Binding type= ns:sendingmanagerport- Type > <soap12:binding transport= style= document /> <wsdl:operation name= sendrequest > <soap12:operation soapaction= urn:sendrequest style= document /> <wsdl:input> <soap12:body use= literal /> </wsdl:input> 51

56 <wsdl:output> <soap12:body use= literal /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:binding name= SendingManagerHttpBinding type= ns:sendingmanagerport- Type > < verb= POST /> <wsdl:operation name= sendrequest > < location= sendrequest /> <wsdl:input> <mime:content type= text/xml part= parameters /> </wsdl:input> <wsdl:output> <mime:content type= text/xml part= parameters /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name= SendingManager > <wsdl:port name= SendingManagerHttpsSoap11Endpoint binding= ns:sendingmanager- Soap11Binding > <soap:address location= /> </wsdl:port> <wsdl:port name= SendingManagerHttpSoap11Endpoint binding= ns:sendingmanager- Soap11Binding > <soap:address location= /> </wsdl:port> <wsdl:port name= SendingManagerHttpsSoap12Endpoint binding= ns:sendingmanager- Soap12Binding > <soap12:address location= /> </wsdl:port> <wsdl:port name= SendingManagerHttpSoap12Endpoint binding= ns:sendingmanager- Soap12Binding > <soap12:address location= /> </wsdl:port> <wsdl:port name= SendingManagerHttpsEndpoint binding= ns:sendingmanagerhttp- Binding > < location= /> </wsdl:port> 52

57 <wsdl:port name= SendingManagerHttpEndpoint binding= ns:sendingmanagerhttpbinding > < location= SendingManagerHttpEndpoint/ /> </wsdl:port> </wsdl:service> </wsdl:definitions> 5.8 Download Raccomandate Digitali e AR\AC via Web Service Metodo di Ricerca L interfaccia dei metodi del webservice per la ricerca dei documenti è la seguente: 53

58 Il parametro di input operatore accetta in input i seguenti parametri (case sensitive): 54

59 Mentre, il parametro ordinamento i seguenti (case sensitive): 55

60 Si riporta di seguito il dettaglio dei parametri in input: Parametro Obbligatorio Controlli Descrizione sistemachiamante SI nessuno Valore che identifica il sistema chiamante, anche valorizzato staticamente Idcliente SI nessuno Valore fornito da Poste che identifica il cliente (ad es: Z ) IdClasseDoc SI Presenza della classe su documentale Flagversionamento NO V a l o r i ammessi Valore fornito da Poste, che identifica la classe documentale (repository) dove saranno inseriti i documenti e i metadati. 1=restituisce sotto forma di lista, tutte le versioni dei documenti che rispondono ai criteri di ricerca,. 0=restitusce la versione corrente dei documenti che rispondono ai criteri di ricerca ListaRicercaIndici SI (almeno 1) Nessuno E composto da una o più triplette di campi (nome, tipo, valore) ognuna delle quali identifica un indice relativo al documento che si sta ricercando ad esempio: Nome: Raccomandata Tipo: STRING Valore: Paginazione NO Nessuno Numero di record che si vogliono restituiti. Esempio: da=1 a=10 Vengono restituiti tutti i risultati a pagine da 10 ciascuna. Ordinamento NO Nessuno ASC=la restituzione sarà dal valore più basso al più alto DESC= la restituzione sarà dal valore più alto al più basso. 56 La response del servizio è la seguente:

61 57 Di seguito il dettaglio degli attributi della response: Parametro Obbligatorio Controlli Descrizione Codice esito SI Valore numerico mappato con una descrizione dell errore DescrizioneEsito SI Descrizione parlante dell errore Esito SI Può essere 0=OK oppure 1=KO ListaDocumenti NO Contiene un set di 4 indici per orgi documento - Id documento - Lista degli indici (con all interno la tripletta come sopra) - NumeroOccorenza - Versione numerodocumentitotali SI Numero dei documenti restitutiti

62 L attributo Codice Esito può assumere i seguenti valori: Codice Descrizione 4 ID Cliente non valorizzato 5 Classe documentale non valorizzata 10 Classe non trovata 11 Documento non trovato 99 Errore generico Di seguito un esempio di implementazione di una chiamata attraverso client JAVA: RicercaDocumentiService serviceric = new RicercaDocumentiService(); RicercaDocumenti ricerca = serviceric.getricercadocumentiport(); Map<, Object> requestcontext = ((BindingProvider)ricerca).getRequestContext(); requestcontext.put(bindingprovider.endpoint_address_property, docufe-coll.intranet.postel.it/wsposte_docufe/ricercadocumentiservice?wsdl ); requestcontext.put(bindingprovider.username_property, docufe_ws_collaudo ); requestcontext.put(bindingprovider.password_property, XXXXXXXXX ); List<RicercaIndici> listindici = new ArrayList<RicercaIndici>(); RicercaIndici indice = new RicercaIndici(); indice.setnomeindice( docid ); indice.setoperatore(operatore.uguale); indice.setvaloreindice( ); listindici.add(indice); Ordinamento ordinamento = new Ordinamento(); ordinamento.setnomeindice( nbpm ); ordinamento.setcriterioordinamento(criterioord.desc); RicercaDocumentiResult resutl = ricerca.ricercadocumenti( Poste, Z , 41F84445DCA769B7E0536F881EAC199A, true, listindici, new Paginazione(), ordinamento); System.out.println( RicercaDocumentiResult + resutl.getesito()); System.out.println( RicercaDocumentiResult + resutl.getcodiceesito()); System.out.println( RicercaDocumentiResult + resutl.getdescrizioneesito()); System.out.println( RicercaDocumentiResult numero doc + resutl.getnumerodocumentitotali()); if (!resutl.getnumerodocumentitotali().equals( 0 )) { for (Documento doc : resutl.getlistadocumenti()) { System.out.println( RicercaDocumentiResult + doc.getiddocumento()); System.out.println( RicercaDocumentiResult + doc.getversione()); System.out.println( RicercaDocumentiResult + doc.getnumerooccorrenza()); for (Indice indici : doc.getlistaindici()) { 58

63 } } System.out.println( indici + indici.getnome()); System.out.println( indici + indici.getvalore()); System.out.println( indici + indici.gettipo()); } Metodo di Download L interfaccia dei metodi del webservice per il download del content del documento interessato è la seguente: 59 Si riporta di seguito il dettaglio dei parametri: Parametro Obbligatorio Controlli Descrizione sistemachiamante SI nessuno Valore che identifica il sistema chiamante, anche valorizzato staticamente Idcliente SI nessuno Valore fornito da Postel che identifica il cliente (ad es: Z ) IdClasseDoc SI Presenza della classe su documentale Valore fornito da Postel, che identifica la classe documentale (repository) dove saranno inseriti i documenti e i metadati. IdDocumento SI Identificativo univoco che il WS restituisce al client chiamante, composto da valori concordati. versione SI Numero della versione che Postel associa al documento