ARIANNA + GUIDA ALLO SVILUPPO PER LE SOFTWARE HOUSE

Транскрипт

1 ARIANNA + GUIDA ALLO SVILUPPO PER LE SOFTWARE HOUSE Primo rilascio documento: ottobre 2007 Ultima revisione documento: novembre 2012

2 ELENCO DELLE MODIFICHE Revisione dicembre 2007 PARAGRAFO PAG. DESCRIZIONE - - In tutto il documento, modifica della descrizione del contenuto delle CLiP con l aggiunta dei titoli usciti di catalogo da luglio 2007 in poi. - - In tutto il documento, sostituzione di server ftp.arianna.org con server ftp di Arianna. - - In tutto il documento, i riferimenti a Fattura, Nota di debito, Nota di credito come tre messaggi separati sono stati modificati in riferimenti a un unico messaggio Ciclo dell ordine 4 Aggiunta della frase: Si noti che i messaggi Avviso di spedizione e Fattura/Nota di debito/nota di credito non sono sostitutivi del documento cartaceo e contengono in formato elettronico i dati utili per il precarico delle merci a magazzino, per il controllo della fattura ecc Dati di vendita 4 Eliminata la parola aggregati dalla descrizione. 4.4 I canali di trasmissione e i nomi dei file 9 Correzione degli indirizzi di esempio ([email protected] e [email protected] anziché [email protected] e [email protected]) Catalogo prodotti 15 Eliminato Numero di pezzi dalle note dell elemento Identificazione e descrizione del prodotto nella tabella Il messaggio Catalogo prodotti 18 Correzione dell ultima frase del paragrafo Il messaggio Disponibilità a 19 Correzione dell ultima frase del paragrafo. magazzino Il messaggio ONIX di informazioni 20 Correzione dell ultima frase del paragrafo. sul prodotto Informazioni contenute nelle CLiP 20 Correzione della tabella (Cedola Novità e Condizioni per il reso non sono disponibili nella CLiP XS) Fattura, Nota di debito, Nota di credito 11 Allegato 2 - Formati disponibili per le CLiP 12 Allegato 3 - Caratteristiche dei record trasmessi nei messaggi Catalogo prodotti e Onix-Informazioni sul prodotto delle clip L e XL 31 Correzione della tabella riepilogativa delle informazioni. 48 Aggiunta dell allegato. 49 Aggiunta dell allegato. Revisione aprile 2008 PARAGRAFO PAG. DESCRIZIONE - - In tutto il documento, l indirizzo è stato sostituito dall indirizzo Arianna + - Guida allo sviluppo per le software house pag. 2/66

3 6.3.5 Informazioni contenute nelle CLiP 23 Aggiornamento dei riferimenti agli allegati nel box alla fine del paragrafo. 12 Allegato 3 - Informazioni minime 51 Aggiunta dell allegato. trasmesse nel messaggio Catalogo prodotti 13 Allegato 4 - Caratteristiche del 52 Aggiunta dell allegato. messaggio Catalogo prodotti delle CLiP L e XL 14 Allegato 5 - Caratteristiche dei dati trasmessi nei messaggi Catalogo prodotti e ONIX-Informazioni sul prodotto delle CLiP XL 56 Modifica del precedente Allegato 3 - Caratteristiche dei record trasmessi nei messaggi Catalogo prodotti e Onix-Informazioni sul prodotto delle clip L e XL. Revisione maggio 2008 PARAGRAFO Conversione dai formati XML e TXT di Arianna+ ai formati EDIFACT e TXT di Arianna 1 PAG. DESCRIZIONE 46 Correzione del codice Boardbook in BoardBook. Revisione febbraio 2009 PARAGRAFO PAG. DESCRIZIONE - In tutto il documento, sostituzione di titoli usciti di catalogo da luglio 2007 in poi con titoli usciti di catalogo nell ultimo anno Servizi web 7 Modifica descrizione Catalogo prodotti 17 Nella tabella, modifica delle note relative all elemento Identificazione e descrizione del prodotto Messaggio ONIX di informazioni sul prodotto 19 Nella tabella, modifica della descrizione e delle note relative all elemento Informazioni sul prodotto Il messaggio Disponibilità a 21 Modifica descrizione. magazzino Il messaggio ONIX di informazioni 22 Modifica descrizione. sul prodotto 6.3 Le CLiP di Arianna+ 22 Modifica descrizione Ordine 24 Nella tabella, modifica delle note relative all elemento Termini e mezzi di pagamento, richiesta di merce in conto deposito di testata ed eliminazione dell elemento Termini e mezzi di pagamento, richiesta di merce in conto deposito di dettaglio Risposta all ordine 27 Nella tabella, eliminazione dell elemento Termini e mezzi di pagamento, richiesta di merce in conto deposito di dettaglio Fase 2: la risposta all ordine del 37 Modifica descrizione. fornitore 9 I servizi web di Arianna+ 41 Modifica descrizione di tutto il capitolo. Arianna + - Guida allo sviluppo per le software house pag. 3/66

4 Revisione ottobre 2009 PARAGRAFO PAG. DESCRIZIONE - Modifica del titolo del documento da Guida al servizio a Guida allo sviluppo per le software house Ciclo dell ordine 8 Modifica della descrizione Servizi web 9 Eliminata la frase effettuare l upload o il download di file. 4.4 I canali di trasmissione e i nomi dei file 13 Eliminata la frase mediante i servizi di Arianna+ all interno del portale ibuk ( Eliminata la frase: I messaggi inviati dall utente come allegati alla mail devono essere inviati a indirizzi di posta elettronica distinti in base al tipo di documento inviato; per es. l ordine va inviato all indirizzo [email protected], la relazione vendite all indirizzo [email protected] ecc Catalogo prodotti 19 Nella tabella, nella riga relativa a Identificazione e descrizione del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Disponibilità a magazzino 20 Nella tabella, nella riga relativa a Identificazione del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Ordine 26 Nella tabella, nella riga relativa a Identificazione della linea e del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Risposta all ordine 29 Nella tabella, nella riga relativa a Identificazione della linea e del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Avviso di spedizione 32 Nella tabella, nella riga relativa a Identificazione della linea e del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Fattura, Nota di debito, Nota di credito 7.2 Il flusso informativo tra i soggetti coinvolti Nella tabella, nella riga relativa a Identificazione della linea e del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN. Aggiunta della frase [FUNZIONALITÀ NON ANCORA DISPONIBILE] nel paragrafo relativo all ordine diretto a un agente L ordine diretto al fornitore 38 La frase L ordine diretto viene indirizzato direttamente a uno specifico fornitore (distributore esclusivo, grossista, editore). è stata sostituita da L ordine diretto viene indirizzato dal mittente a uno specifico fornitore (distributore esclusivo, grossista, editore) e a questi trasmesso tramite Arianna L ordine diretto all agente e la risposta dell agente [funzionalità non ancora disponibile] 38 Aggiunta della frase [FUNZIONALITÀ NON ANCORA DISPONIBILE] nel titolo del paragrafo. 8 I dati di vendita 41 Eliminata la frase Nel nuovo sistema Arianna + anche le librerie possono trarre vantaggio dall invio dei propri dati di vendita: è infatti possibile, tramite il sito web (vedi il successivo capitolo 10 I servizi web di Arianna+), comparare i propri dati di sell-out Arianna + - Guida allo sviluppo per le software house pag. 4/66

5 con quelli aggregati di tutte le librerie Arianna +. In questo modo ogni singola libreria può avere una fotografia della sua posizione ed effettuare simulazioni e previsioni sulla base delle variabili che ritiene più opportune. La frase Vista l importanza di queste informazioni, il messaggio Relazione vendite inviato dalle librerie non viene immediatamente rediretto verso i destinatari, ma verificato da Arianna + e solo in un secondo momento distribuito agli utenti abilitati. è stata sostituita da: I dati ricevuti vengono verificati a campione dalla redazione di Arianna + che ne controlla la completezza e la congruenza Relazione vendite 41 Nella tabella, nella riga relativa a Identificazione della linea e del prodotto, eliminata la frase Identificazione tramite codice Alice di prodotti sprovvisti di EAN Record di distributori non Arianna 52 Modifica della descrizione. Revisione novembre 2012 PARAGRAFO PAG. DESCRIZIONE Messaggi di reso 8 Aggiunta del paragrafo. 4.1 I formati dei messaggi 12 Correzione delle sigle dei messaggi di reso nella tabella. 8 La spedizione di merci rese 41 Aggiunta del capitolo Segnalibro 48 Aggiornamento della descrizione Conversione dai formati XML e TXT di Arianna+ ai formati EDIFACT e TXT di Arianna 1 50 Aggiornamento della mappatura dei codici MixedMediaProduct, QuantityPack e CounterpackFilled. Arianna + - Guida allo sviluppo per le software house pag. 5/66

6 INDICE 1 Cos è Arianna I servizi di Arianna Anagrafiche Ciclo dell ordine Messaggi di reso Dati di vendita Servizi web Il sistema Arianna I partecipanti Come si diventa partecipanti di Arianna L attribuzione dell EAN Location Code e l inserimento nel database degli utenti Formato dei messaggi e modalità di trasmissione I formati dei messaggi La conversione dei messaggi nei vari formati L imbustamento dei messaggi XML nell interchange I canali di trasmissione e i nomi dei file La conferma della ricezione dell interchange e della correttezza del messaggio I messaggi di servizio Ricevuta di interchange Accettazione di messaggio Ricevuta di file TXT Il flusso dei messaggi di servizio La ricevuta di interchange L accettazione di messaggio La ricevuta di file TXT Le anagrafiche prodotti I messaggi di anagrafica Catalogo prodotti Disponibilità a magazzino Messaggio ONIX di informazioni sul prodotto Il flusso dei messaggi di anagrafica Il messaggio Catalogo prodotti Il messaggio Disponibilità a magazzino Il messaggio ONIX di informazioni sul prodotto Le CLiP di Arianna Il ciclo dell ordine I messaggi del ciclo dell ordine Ordine Risposta all ordine Avviso di spedizione Fattura, Nota di debito, Nota di credito Il flusso informativo tra i soggetti coinvolti Fase 1: l invio dell ordine Fase 2: la risposta all ordine del fornitore Fase 3: l avviso di spedizione Fase 4: la fattura La spedizione di merci rese I messaggi di reso Avviso di spedizione di reso Avviso di ricevimento di reso Il flusso informativo tra i soggetti coinvolti I dati di vendita I messaggi di sell-out Arianna + - Guida allo sviluppo per le software house pag. 6/66

7 9.1.1 Relazione vendite Il flusso informativo tra i soggetti coinvolti I servizi web di Arianna Ricerche Cercalibro Anagrafiche soggetti e aggiornamento dei dati Servizi Arianna Trovalibro WebOrdering Segnalibro Servizi per editori, reti promozionali e distributori Servizi per le librerie Notizie Allegato 1 - Elenco delle modifiche al contenuto dei messaggi in fase di conversione Messaggio Catalogo prodotti Tipo Prodotto Stato editoriale e Disponibilità Prezzo Allegato 2 - Formati disponibili per le CLiP Allegato 3 - Informazioni minime trasmesse nel messaggio Catalogo prodotti Allegato 4 - Caratteristiche del messaggio Catalogo prodotti delle CLiP L e XL I record contenuti Modalità di raccolta e aggiornamento dei dati Record di distributori Arianna Record di distributori non Arianna Caratteristiche dei dati trasmessi nei record Ingresso e uscita di un prodotto dal circuito Arianna La gestione degli aggiornamenti Allegato 5 - Caratteristiche dei dati trasmessi nei messaggi Catalogo prodotti e ONIX-Informazioni sul prodotto delle CLiP XL I record trasmessi Le informazioni comuni a entrambi i messaggi Titolo Autore e curatore Editore Collana e Numero di collana Tipologia di prodotto Arianna + - Guida allo sviluppo per le software house pag. 7/66

8 1 COS È ARIANNA + Arianna +, evoluzione di Arianna, è un sistema integrato di servizi di comunicazione e teleordinazione basato su standard EDI 1 rivolto a tutti gli operatori economici del mondo del libro. Attraverso Arianna + i partecipanti al sistema possono ricevere informazioni anagrafiche e scambiare messaggi in formato standard secondo modalità predefinite, in modo tale che un sistema informatico li possa elaborare automaticamente e senza ambiguità. 1.1 I servizi di Arianna Anagrafiche Arianna + mette a disposizione dei propri utenti i dati anagrafici di tutti i libri in commercio e di prossima pubblicazione in Italia e dei titoli usciti di catalogo nell ultimo anno. Vengono inoltre forniti i dati commerciali di dettaglio dei titoli distribuiti dai fornitori aderenti al sistema, compresa la disponibilità del prodotto a magazzino. Per maggiori informazioni sulle anagrafiche Arianna + si rinvia al capitolo 6 Le anagrafiche prodotti Ciclo dell ordine In Arianna + i partecipanti possono scambiare messaggi relativi a tutte le fasi del ciclo dell ordine: Ordini Risposta all ordine Avviso di spedizione Fattura/Nota di debito/nota di credito Arianna + offre un sistema di smistamento automatico dell ordine: l acquirente può creare un unico ordine contenente prodotti di competenza di distributori diversi e indirizzarlo ad Arianna + che provvede al reindirizzamento ai vari distributori delle sole linee d ordine di competenza. Si noti che i messaggi Avviso di spedizione e Fattura/Nota di debito/nota di credito non sono sostitutivi del documento cartaceo e contengono in formato elettronico i dati utili per il precarico delle merci a magazzino, per il controllo della fattura ecc. Per maggiori informazioni sul ciclo dell ordine si rinvia al capitolo 7 Il ciclo dell ordine Messaggi di reso In Arianna + i partecipanti possono scambiare informazioni relative alle merci rese utilizzando due messaggi: Avviso di spedizione di reso, trasmesso dalla parte che spedisce le merci da rendere alla parte che le riceve, allo scopo di fornire informazioni dettagliate relative alle merci spedite, ai tempi e alle modalità di spedizione. Avviso di ricevimento di reso, trasmesso dalla parte che riceve le merci rese alla parte che le ha spedite, allo scopo di fornire un riscontro dell avvenuta ricezione. 1 Con il termine EDI (Electronic Data Interchange) si intende la trasmissione diretta tra sistemi di partner commerciali diversi di dati strutturati secondo uno standard comune. Arianna + - Guida allo sviluppo per le software house pag. 8/66

9 Per maggiori informazioni sui messaggi di reso si rinvia al capitolo 8 La spedizione di merci rese Dati di vendita Arianna + riceve quotidianamente i dati di vendita dalle librerie e ne verifica la correttezza e la completezza. I dati vengono poi smistati e inviati quotidianamente, per i soli prodotti di propria competenza, agli utenti autorizzati (Editori, Promotori, Distributori, Istituti di ricerca) che possono in tal modo evitare rotture di stock, pianificare ristampe e nuove edizioni e conoscere l effettivo andamento di un titolo. Per maggiori informazioni sui Dati di vendita si rinvia al capitolo 9 I dati di vendita Servizi web Arianna + offre ai propri utenti la possibilità di accedere a un area all interno del portale in cui: ricercare nel catalogo libri e prodotti inserire ordini analizzare i propri dati di vendita (sia in termini numerici sia percentuali) secondo vari parametri e confrontarli con quelli del mercato visualizzare classifiche e statistiche di interesse generale Per maggiori informazioni sui Servizi web si rinvia al capitolo 10 I servizi web di Arianna+. Arianna + - Guida allo sviluppo per le software house pag. 9/66

10 INTERNET 2 IL SISTEMA ARIANNA + Il sistema Arianna+ è costituito dalle seguenti componenti: un sistema di comunicazione accessibile via Internet tramite il canale FTP e per compatibilità con Arianna 1 anche tramite il canale Mail; un sistema di interscambio per l acquisizione controllata e la distribuzione dei messaggi basato su SAP XI nativamente XML e per compatibilità con Arianna 1 anche Edifact e formato testo; un sistema di trattamento e di archiviazione dei messaggi basato su WAS Netweaver di SAP e su SAP DB; un sistema di consolidamento e di archiviazione storica dei principali dati collegati ai messaggi (sellout e traffico) basato su SAP BI; un sistema di accesso e di presentazione dei dati e delle funzionalità basato su SAP Enterprise Portal. Sistema di comunicazione Sistema di interscambio DB messaggi DB statistiche Sistema di presentazione Arianna + - Guida allo sviluppo per le software house pag. 10/66

11 3 I PARTECIPANTI Arianna + nasce dalla volontà di mettere in comunicazione in modo rapido ed efficace tutti gli attori della filiera del libro: editori, reti promozionali, distributori, grossisti, librerie. Il database degli utenti di Arianna + contenente i dati anagrafici e le informazioni relative alla modalità di accesso al servizio di ciascun partecipante. 3.1 Come si diventa partecipanti di Arianna + Per accedere ad Arianna + è necessario stipulare un contratto e accettare le Condizioni generali del servizio descritte nel documento Condizioni_generali_servizio.pdf scaricabile dal sito Il contratto prevede un costo fisso per l abbonamento all infrastruttura di Arianna + e dei costi variabili a seconda dei servizi acquistati. La descrizione dei servizi e il listino prezzi sono disponibili sul sito L attribuzione dell EAN Location Code e l inserimento nel database degli utenti Una volta formalizzata con la firma del contratto l adesione al sistema, l agenzia Arianna attribuisce al nuovo partecipante un EAN Location Code, codice standard che permette di identificare l utente in maniera univoca all interno del sistema. A ciascun partecipante vengono inoltre assegnate una password per l accesso al sistema e una password operativa per accedere alle funzioni dispositive. Il partecipante è tenuto a fornire alla segreteria operativa Arianna tutti i dati necessari per aggiornare il database degli utenti e a comunicare tempestivamente qualsiasi modifica. I dati presenti nel database degli utenti sono riservati e non sono resi pubblici ad eccezione di quelli strettamente necessari al funzionamento del sistema. Questi ultimi sono a disposizione per il download sul server ftp di Arianna. La descrizione dei dati dei partecipanti visibili da tutti gli utenti di Arianna + sono descritti nel documento Partecipanti_Produttori.pdf contenuto nel file Anagrafiche.zip scaricabile dal sito Arianna + - Guida allo sviluppo per le software house pag. 11/66

12 4 FORMATO DEI MESSAGGI E MODALITÀ DI TRASMISSIONE 4.1 I formati dei messaggi In Arianna + i messaggi possono essere scambiati in due formati standard: XML e testo. I messaggi in formato XML sono strutturati in modo da poter trasmettere informazioni complete e dettagliate, mentre i messaggi di testo sono definiti per contenere solamente le informazioni essenziali associate a una particolare transazione Arianna +. In altre parole, non esiste una corrispondenza 1:1 tra le informazioni trasmesse in un messaggio XML e quelle trasmesse nell analogo messaggio di testo: quest ultimo, infatti, contiene solo un sottoinsieme delle informazioni che possono essere inserite in un messaggio XML. Per alcuni messaggi è previsto un solo formato. Arianna +, inoltre, garantisce la compatibilità con i formati dei messaggi EDIFACT e testo gestiti nella precedente versione del sistema. La compatibilità con i formati preesistenti si limita ai soli elementi/campi effettivamente utilizzati dagli utenti fino a marzo 2007, e non a tutti gli elementi/campi teoricamente previsti nel Manuale tecnico di riferimento, versione 1.3.1, 2/12/1999 del precedente sistema. Di seguito viene fornito l elenco dei messaggi gestiti nel sistema Arianna + e dei formati supportati per ciascuno di essi. Messaggio Sigla XML TXT Formati Arianna 1 Catalogo prodotti PRICAT Si Si Si Informazioni sul prodotto ONIX Si No No Disponibilità a magazzino STKRPT No Si No Ordini ORDERS Si Si Si Risposta all ordine ORDRSP Si Si Si Avviso di spedizione DESADV Si Si Si Fattura, Nota di debito, Nota di credito INVOIC Si No No Avviso di spedizione di reso RETADV Si No No Avviso di ricevimento di reso RECADV Si No No Relazione vendite SLSRPT Si Si Si Ricevuta di interchange APKICG Si No Si Accettazione di messaggio APKMSG Si No No Ricevuta di file TXT TXTACK No Si No 4.2 La conversione dei messaggi nei vari formati Ciascun partecipante può scegliere per ciascun messaggio il formato in cui lo vuole ricevere o inviare. Questo significa che il mittente di un messaggio può scegliere di inviarlo in un formato diverso da quello in cui lo desidera ricevere il destinatario. Arianna + si fa carico della traduzione del messaggio da un formato all altro, ossia del ricollocamento delle informazioni contenute nella struttura dei dati di partenza nella struttura dei dati di arrivo. In questo processo di traduzione si possono verificare alcuni eventi critici: Arianna + - Guida allo sviluppo per le software house pag. 12/66

13 quando un messaggio in formato XML viene convertito in formato testo e contiene informazioni che non sono previste nel tracciato record di quest ultimo, tali informazioni vengono scartate; quando un messaggio in formato testo o XML viene convertito da/a un formato della precedente versione di Arianna e contiene informazioni che non sono previste nel formato di destinazione, tali informazioni vengono scartate; quando un messaggio in formato testo o XML viene convertito da/a un formato della precedente versione di Arianna e contiene informazioni che sono gestite in maniera differente nel formato di destinazione, l informazione viene modificata per adattarla al formato di destinazione. Nell Allegato 1 - Elenco delle modifiche al contenuto dei messaggi in fase di conversione vengono descritti nel dettaglio i casi in cui le informazioni presenti in un formato vengono modificate durante la conversione in un altro formato. 4.3 L imbustamento dei messaggi XML nell interchange Il termine interchange mutuato dall EDIFACT rappresenta una sessione di scambio di più documenti tra due partner, unitaria e temporalmente delimitata. In Arianna + un interchange consiste in un opportuno raggruppamento di più messaggi XML che vengono inviati nel corso di un unica transazione telematica ed è costituito da una busta che contiene uno o più messaggi. I messaggi all interno di un interchange devono essere tutti dello stesso tipo; non è consentito, per esempio, l invio di messaggi di ordine assieme a messaggi di relazione vendite nello stesso interchange. I messaggi di testo, invece, non vengono inseriti in un interchange. Un file di testo può contenere un solo messaggio. La struttura dell interchange è definita tramite uno schema XML, contenuto nel file Schemi.zip scaricabile dal sito La descrizione dettagliata della struttura dell interchange è disponibile nel documento XML_Schemi_Interchange.pdf contenuto nel file Documenti_generali.zip scaricabile dal sito I canali di trasmissione e i nomi dei file In Arianna + i messaggi possono essere trasmessi in tre modalità: tramite trasferimento FTP come allegati di posta elettronica (solo per compatibilità con la precedente versione di Arianna) La trasmissione/ricezione via FTP va effettuata collegandosi al server FTP di Arianna previa autenticazione da parte dell utente: i partecipanti figurano come client del server FTP al quale si devono collegare con la propria utenza e password. Ciascun utente accede esclusivamente a una propria home directory sul server contenente, in cartelle distinte, i file inviati, quelli ricevuti e quelli archiviati. Arianna + - Guida allo sviluppo per le software house pag. 13/66

14 Il trasferimento via FTP è preferibile rispetto a quello via posta elettronica per ragioni di sicurezza; l FTP, infatti, prevede già a livello di protocollo una forma di autenticazione delle utenze. Per questo motivo l FTP è l unico metodo di trasmissione ammesso per chi invia messaggi in formato XML e nei nuovi formati TXT. Solo per ragioni di compatibilità con le modalità di trasmissione del sistema precedente, i messaggi nei formati di testo ed Edifact già implementati in Arianna 1 possono essere inviati e ricevuti anche via posta elettronica. Di seguito viene fornito un riepilogo delle modalità di trasmissione ammesse per ciascun formato dei messaggi. Formato XML Testo EDIFACT Testo formato Arianna 1 Modalità di trasmissione FTP, Web FTP, Web FTP, Mail FTP, Mail I file trasmessi devono essere nominati seguendo delle regole precise che permettono di identificare il tipo di messaggio, il formato, la data ecc. La descrizione dettagliata delle modalità di trasmissione e delle regole per nominare i file è disponibile nel documento RegoleTrasmissioneDocumenti.pdf contenuto nel file Documenti_generali.zip scaricabile dal sito Arianna + - Guida allo sviluppo per le software house pag. 14/66

15 5 LA CONFERMA DELLA RICEZIONE DELL INTERCHANGE E DELLA CORRETTEZZA DEL MESSAGGIO In un sistema in cui due parti si scambiano documenti in formato elettronico in modalità automatica è sempre prevista una forma di ricevuta elettronica che consenta al mittente dei documenti di avere conferma dell avvenuta ricezione e delle modalità in cui questa è avvenuta. In Arianna + vengono utilizzati a questo scopo i seguenti messaggi: Ricevuta di interchange, trasmesso da Arianna + al mittente di un interchange e dal destinatario di un interchange ad Arianna + per comunicare che l interchange è stato ricevuto e che i messaggi in esso contenuti sono risultati leggibili in tutto o in parte oppure non leggibili. Accettazione di messaggio, trasmesso da Arianna + al mittente di un interchange per comunicare il risultato dell elaborazione di merito sui singoli messaggi contenuti nell interchange. Ricevuta di file TXT, trasmesso da Arianna + al mittente di un messaggio TXT per fornire un riscontro sulla correttezza formale dei dati in esso contenuti. Di seguito viene fornita una descrizione sintetica delle informazioni che devono/possono essere trasmesse in ciascun messaggio e una descrizione del flusso informativo tra i vari soggetti coinvolti. 5.1 I messaggi di servizio Ricevuta di interchange Questo messaggio è disponibile solo in formato XML. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Destinatario della notifica. DETTAGLIO (informazioni valide per la singola linea) Informazioni obbligatorie (eccetto il destinatario della notifica). Dettagli della trasmissione dell interchange Identificazione e dettagli dell interchange Azione intrapresa Tipo di trasporto e codifica MIME (se mail). Nome del file originario. Data e ora effettivamente rilevata della trasmissione e della ricezione dell interchange. Indirizzo IP del mittente e del destinatario. Tipo di documento EDI. Numero e data dell interchange. Mittente e destinatario dell interchange. Numero di interchange attribuito dal destinatario. Azione intrapresa dopo la verifica dell interchange (accettato in tutto o in parte, rifiutato). Il numero di interchange di cui si dà ricevuta è obbligatorio. Informazione obbligatoria. Arianna + - Guida allo sviluppo per le software house pag. 15/66

16 INFORMAZIONE DESCRIZIONE NOTE Descrizione degli errori riscontrati Identificazione e dettagli dei messaggi contenuti nell interchange Livello di errore (avvertimento, errore non bloccante, errore bloccante). Codice e posizione dell errore. Numero di messaggio e posizione nell interchange. Tipo di messaggio. Mittente e destinatario del messaggio. Numero e data del documento. Numero di messaggio attribuito dal destinatario. SOMMARIO (informazioni di riepilogo) Informazioni di riepilogo Numero di messaggi. Informazione obbligatoria Accettazione di messaggio Questo messaggio è disponibile solo in formato XML. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Destinatario della notifica. DETTAGLIO (informazioni valide per la singola linea) Informazioni obbligatorie (eccetto il destinatario della notifica). Dettagli della trasmissione dell interchange Identificazione e dettagli dell interchange Tipo di trasporto e codifica MIME (se mail). Nome del file originario. Data e ora effettivamente rilevata della trasmissione e della ricezione dell interchange. Indirizzo IP del mittente e del destinatario. Tipo di documento EDI. Numero e data dell interchange. Mittente e destinatario dell interchange. Numero di interchange attribuito dal destinatario. Numero e data della ricevuta di interchange che precede logicamente l accettazione del messaggio corrente. Le informazioni relative al Tipo di trasporto e alla data/ora della ricezione sono obbligatorie. Il numero di interchange contenente il messaggio di cui si dà ricevuta è obbligatorio. Arianna + - Guida allo sviluppo per le software house pag. 16/66

17 INFORMAZIONE DESCRIZIONE NOTE Identificazione e dettagli dei messaggi contenuti nell interchange Numero di messaggio e posizione nell interchange. Tipo di messaggio. Mittente e destinatario del messaggio. Numero e data del documento. Numero di messaggio attribuito dal destinatario. Azione intrapresa (messaggio accettato totalmente, parzialmente o rifiutato). Livello di errore (avvertimento, errore non bloccante, errore bloccante). Codice e posizione dell errore. Il numero di messaggio e di posizione, il tipo di messaggio e l azione intrapresa sono obbligatori Ricevuta di file TXT Questo messaggio è disponibile solo in formato TXT. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del file e azione intrapresa Nome del file. Azione intrapresa (messaggio accettato totalmente o parzialmente oppure rifiutato). DETTAGLIO (informazioni valide per la singola linea) Informazioni obbligatorie. Errori Livello e codice di errore, posizione dell errore. SOMMARIO (informazioni di riepilogo) Informazioni di riepilogo Numero di linee. Informazione obbligatoria. 5.2 Il flusso dei messaggi di servizio La ricevuta di interchange La Ricevuta di interchange viene trasmessa dal destinatario al mittente di un interchange per comunicare che l interchange è stato ricevuto e che i messaggi in esso contenuti sono risultati leggibili in tutto o in parte oppure non leggibili. La ricevuta, dunque, non si limita a confermare la ricezione di qualcosa, ma anche a verificarne la leggibilità formale, pur non comportando l elaborazione di merito del contenuto del documento. Tale analisi formale solitamente riveste una certa complessità. Per liberare i partecipanti da tale onere, è Arianna + stessa a effettuare tali controlli, in modo da garantire al destinatario dell interchange la ricezione di un documento formalmente corretto o, in caso di anomalie, provvedendo in sua vece a risolverle presso il mittente. Ne consegue che il mittente dell interchange riceve la ricevuta da Arianna + e non dal destinatario. Arianna + - Guida allo sviluppo per le software house pag. 17/66

18 Qualora il mittente di un interchange non riceva la ricevuta da Arianna + entro ventiquattr ore deve considerare l invio dell interchange fallito e provvedere a un nuovo invio. Il mittente dunque invia un interchange, Arianna + lo intercetta ed effettua una verifica formale dandone ricevuta al mittente. Se l interchange è corretto, lo inoltra al destinatario che è a sua volta tenuto a dare riscontro dell avvenuta ricezione ad Arianna +. Qualora non riceva tale riscontro entro ventiquattr ore, Arianna + provvede a effettuare i controlli necessari ed eventualmente a re-inviare l interchange. Per informazioni di dettaglio sul messaggio Ricevuta di interchange si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RAperakIXml200.pdf) e Guida all utilizzo (UAperak-Xml200.pdf) del messaggio Ricevuta di interchange in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip L accettazione di messaggio Arianna + non si limita a una verifica formale dell interchange, ma effettua anche una pre-elaborazione di merito del contenuto dei messaggi. Il risultato di tale pre-elaborazione viene comunicato al mittente dell interchange mediante il messaggio Accettazione di messaggio in cui, per ciascun messaggio, viene comunicato se è stato accettato in tutto o in parte oppure rifiutato e in cui viene fornito l elenco degli errori riscontrati dai semplici warning agli errori bloccanti. Per informazioni di dettaglio sul messaggio Accettazione di messaggio si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RAperakMXml200.pdf) e Guida all utilizzo (UAperak-Xml200.pdf) del messaggio Accettazione di messaggio in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip La ricevuta di file TXT Come descritto in precedenza, i messaggi in formato testo non vengono inseriti in un interchange, non è dunque possibile inviare una ricevuta di interchange per questo tipo di messaggi. Per fornire un riscontro sulla correttezza formale dei dati e dunque sull accettazione o meno di un messaggio di testo, il sistema Arianna + invia ai mittenti di tali messaggi un messaggio ad hoc nominato Ricevuta di file TXT. Per informazioni di dettaglio sul messaggio Ricevuta di file TXT si faccia riferimento alla Guida ai messaggi TXT (Messaggi_TXT.pdf) scaricabile dal sito Arianna + - Guida allo sviluppo per le software house pag. 18/66

19 6 LE ANAGRAFICHE PRODOTTI I fornitori che aderiscono ad Arianna + sono tenuti a fornire una tantum l intero catalogo dei prodotti distribuiti e poi a inviare quotidianamente le informazioni relative alle novità e alle variazioni. Ai fornitori viene inoltre richiesto di inviare i dati relativi alla disponibilità dei prodotti nei propri magazzini. I dati ricevuti dai fornitori vengono verificati dalla redazione di Arianna +, completati con informazioni bibliografiche e catalografiche di dettaglio e trasmessi alle librerie con diversi gradi di completezza e di profondità a seconda del contratto stipulato. I messaggi che permettono di trasmettere informazioni sui prodotti sono tre: Catalogo prodotti, contenente le informazioni anagrafiche e logistico-commerciali. Disponibilità a magazzino, contenente i dati sulla disponibilità del prodotto a magazzino. Informazioni sul prodotto (ONIX), contenente le informazioni bibliografiche e catalografiche di dettaglio. Di seguito viene fornita una descrizione sintetica delle informazioni che devono/possono essere trasmesse in ciascun messaggio e una descrizione del flusso informativo tra i vari soggetti coinvolti. 6.1 I messaggi di anagrafica Catalogo prodotti Questo messaggio è disponibile sia in formato XML che in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale) del documento. Informazioni obbligatorie. DETTAGLIO (informazioni valide per la singola linea) Informazioni sullo stato del record Numero di riferimento univoco del record. Stato del record (nuovo, variato, sostituito, cancellato, eliminato dal sistema, nessuna azione). Tipologia (agenzia bibliografica, distributore ecc.) e nome dell organizzazione che ha emesso il record. Data di creazione, dell ultima modifica, di cancellazione del record. Il numero di riferimento e lo stato del record sono obbligatori. Sono richieste (ma non obbligatorie per permettere l invio di record contenenti i soli campi variati) le informazioni relative a: Data creazione record, Data dell ultima modifica (se il record è variato o sostituito), Data di cancellazione (se il record è cancellato o eliminato dal sistema). Nei messaggi di testo non sono gestiti Tipologia e Nome dell organizzazione che ha emesso il record. Arianna + - Guida allo sviluppo per le software house pag. 19/66

20 INFORMAZIONE DESCRIZIONE NOTE Identificazione e descrizione del prodotto Informazioni logisticocommerciali Identificazione tramite EAN. Tipologia di prodotto, Numero di pezzi e Misure. Titolo, Responsabilità, Collana, Nic, Codice e partizione EAN del produttore. Stato editoriale, Data di pubblicazione, Data di fuori catalogo. EAN Location Code del fornitore e province di competenza. Nuovo distributore. Disponibilità e Ordinabilità. Informazioni sul reso. Data di ristampa prevista, Data di disponibilità prevista, Data limite per il reso. Prezzo corrente e Nuovo prezzo. Numero, periodo di validità e condizioni particolari (sconti, termini di pagamento, quantità minima e massima ordinabile, quantità gratuita) di Promozioni e Cedole novità. SOMMARIO (informazioni di riepilogo) L identificazione del prodotto è obbligatoria. Sono richieste (ma non obbligatorie per permettere l invio di record contenenti i soli campi variati) le informazioni relative a: Tipologia di prodotto, Titolo, Partizione EAN del produttore, Stato editoriale, Data di pubblicazione (per i titoli in commercio o di prossima pubblicazione), Data di fuori catalogo (per i record usciti di catalogo).. L identificazione del fornitore è obbligatoria. Sono richieste (ma non obbligatorie per permettere l invio di record contenenti i soli campi variati) le informazioni relative a: Disponibilità, Ordinabilità e Prezzo (esclusi i prodotti non ancora in commercio). Nei messaggi di testo non sono gestiti il Nuovo distributore e le condizioni particolari di Promozioni e Cedole novità. Informazioni di riepilogo Numero di linee. Informazione obbligatoria. Per informazioni di dettaglio sul messaggio Catalogo prodotti si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RPricat-Xml200.pdf) e Guida all utilizzo (UPricat-Xml200.pdf) del messaggio Catalogo prodotti in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. Guida al messaggio Catalogo prodotti in formato testo contenuta nella più generale Guida ai messaggi TXT (Messaggi_TXT.pdf) Disponibilità a magazzino Questo messaggio è disponibile solo in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale) del documento. Informazioni obbligatorie. Arianna + - Guida allo sviluppo per le software house pag. 20/66

21 INFORMAZIONE DESCRIZIONE NOTE Tipologia di disponibilità Identificazione del magazzino Tipologia di disponibilità trasmessa (quantità esatta o codice) ed eventuale Tabella dei codici di disponibilità utilizzata. EAN Location Code del magazzino. DETTAGLIO (informazioni valide per la singola linea) Questa informazione viene fornita in testata solo nei messaggi inviati dal magazzino/fornitore ad Arianna +. Questa informazione viene fornita in testata solo nei messaggi inviati ad Arianna + e solo quando il mittente del messaggio è diverso dal magazzino. Identificazione del prodotto Tipologia di disponibilità Disponibilità Identificazione tramite EAN. Tipologia di disponibilità trasmessa (quantità esatta o codice) ed eventuale Tabella dei codici di disponibilità utilizzata. Quantità esatta o codice. L identificazione del prodotto è obbligatoria. Questa informazione viene fornita su ciascuna linea di dettaglio solo nei messaggi inviati da Arianna + alle librerie. Identificazione del magazzino EAN Location Code del magazzino. SOMMARIO (informazioni di riepilogo) Questa informazione viene fornita su ciascuna linea di dettaglio solo nei messaggi inviati da Arianna + alle librerie. Informazioni di riepilogo Numero di linee. Informazione obbligatoria. Per informazioni di dettaglio sul messaggio Disponibilità a magazzino si faccia riferimento alla Guida ai messaggi TXT (Messaggi_TXT.pdf) scaricabile dal sito Messaggio ONIX di informazioni sul prodotto Questo messaggio è disponibile solo in formato XML. ONIX è un formato standard internazionale sviluppato da EDItEUR. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente e destinatario del documento. Lingua, prezzo e valuta di default del messaggio. DETTAGLIO (informazioni valide per la singola linea) Informazioni obbligatorie, eccetto i valori di default. Informazioni sullo stato del record Codice identificativo del record. Stato del record. Tipologia (agenzia bibliografica, distributore ecc.) e nome dell organizzazione che ha emesso il record. Il numero di riferimento e lo stato del record sono obbligatori. Arianna + - Guida allo sviluppo per le software house pag. 21/66

22 INFORMAZIONE DESCRIZIONE NOTE Informazioni sul prodotto Codici identificativi del prodotto. Tipologia di prodotto (Tipologia principale del prodotto, Dettagli sulla tipologia di prodotto, Descrizione della tipologia di prodotto, Categoria commerciale). Serie (Codice identificativo, Titolo e Numerazione all interno della serie). Insieme (Codice identificativo, Titolo dell insieme, Numerazione e Titolo del sottoinsieme, Numerazione all interno dell insieme, Titolo del prodotto all interno dell insieme). Titolo (Tipo di titolo, Titolo completo, Prefisso del titolo, Titolo senza prefisso, Sottotitolo). Responsabilità (Tipo, Nome di persona in forma diretta e inversa, Nome di persona suddiviso in parti). Congressi (Numero, Denominazione, Data, Luogo, Promotore). Edizione (Tipo, Numero, Descrizione, Bibbia, Caratteristica del testo religioso). Lingua. Estensione del prodotto e altri contenuti (Numero di pagine, Estensione del prodotto, Illustrazioni e altri contenuti). Soggetto del prodotto (Classificazione Decimale Dewey, Soggetti e Qualificatori CCE, Tipologia di contenuto, Classificazione CEC, Argomento CEC). Destinatari del prodotto. Descrizioni e altri testi accompagnatori. Collegamenti a file di immagini, Sito internet del prodotto. Editore (Codice, Descrizione, Ruolo nei confronti del prodotto, Luogo di pubblicazione) e Marchio editoriale (Descrizione). Prodotti correlati. Le informazioni in corsivo nella colonna Descrizione sono disponibili unicamente per i record di editori aderenti al «Consorzio per l Editoria Cattolica» (CEC). Ristampe (Data e Descrizione). Per informazioni di dettaglio sul messaggio ONIX di Informazioni sul prodotto si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Il documento introduttivo ProductMessageXml200.pdf, contenuto nel file Messaggi_XML.zip Gli schemi XSD, contenuti nel file Schemi_ONIX_Arianna.zip. Arianna + - Guida allo sviluppo per le software house pag. 22/66

23 6.2 Il flusso dei messaggi di anagrafica L archivio centrale dei prodotti e delle disponibilità a magazzino è mantenuto costantemente aggiornato mediante i messaggi di anagrafica inviati quotidianamente dai distributori ad Arianna +. Arianna + riceve i dati da ciascun distributore, effettua i controlli necessari e invia quotidianamente alle librerie i dati di tutti i distributori partecipanti al sistema Il messaggio Catalogo prodotti Al distributore è richiesto un primo invio ad Arianna + nelle modalità concordate con la segreteria operativa dell anagrafica completa dei prodotti di propria competenza. Successivamente, con cadenza quotidiana, il distributore invia via FTP (o via ) l anagrafica contenente le sole novità e variazioni al proprio catalogo. Può essere re-inviato o l intero record completo di tutti i campi o il record contenente i soli campi variati. I record inviati dai vari distributori vengono inseriti nell archivio centrale di Arianna + e controllati dalla redazione. Ogni giorno Arianna + invia alle librerie il messaggio Catalogo prodotti contenente i soli record variati rispetto all invio precedente. Le librerie che entrano a far parte di Arianna + devono innanzitutto prelevare l anagrafica completa dei prodotti disponibile sul server ftp di Arianna. Successivamente, con cadenza quotidiana, devono scaricare dalla propria cartella sul server ftp (o dalla propria casella di posta) il messaggio Catalogo prodotti inviato da Arianna + e importarlo per aggiornare la propria base dati. Utilizzando le anagrafiche distribuite da Arianna +, la libreria può verificare lo stato di ordinabilità aggiornato dei prodotti. Il messaggio Catalogo prodotti può contenere dati qualitativamente e quantitativamente differenti a seconda dell offerta commerciale sottoscritta dalla libreria (vedi il successivo paragrafo 6.3 Le CLiP di Arianna+). Nella stessa struttura di messaggio, cioè, possono essere trasmessi: i record così come vengono inviati dai distributori ad Arianna +, prima del lavoro redazionale di verifica e normalizzazione. i record inviati dai distributori ad Arianna + normalizzati dalla redazione e i record di prodotti in commercio, di prossima pubblicazione o usciti di catalogo nell ultimo anno dotati di EAN pubblicati da editori i cui distributori non aderiscono al sistema Arianna +. In base all abbonamento sottoscritto, la libreria potrà scaricare l anagrafica completa e ricevere gli aggiornamenti per la sola tipologia di dati acquistata. Qualora una libreria intenda passare da un tipo di abbonamento a un altro, dovrà ricaricare la base dati completa e aggiornarla quotidianamente con i record nuovi e variati inviati da Arianna +. La base dati completa per ciascuna tipologia di abbonamento è sempre disponibile. In caso di necessità, previo contatto con la segreteria operativa Arianna, la libreria può riallineare le anagrafiche presenti sul proprio gestionale con quelle di Arianna Il messaggio Disponibilità a magazzino Il fornitore (distributore o grossista) invia quotidianamente ad Arianna + per ciascun magazzino un messaggio con i record di tutti i titoli disponibili in quel magazzino. Arianna + - Guida allo sviluppo per le software house pag. 23/66

24 Arianna + carica questi dati nel proprio database, dove vengono mantenuti in modo persistente e aggiornati a ogni invio del messaggio di Disponibilità a magazzino da parte del fornitore. Dopo aver confrontato per ciascun magazzino di ciascun fornitore i dati dell ultimo messaggio con quelli dell invio precedente, Arianna + crea un messaggio di Disponibilità a magazzino contenente soltanto i record di prodotti nuovi o con disponibilità variata rispetto all ultimo invio relativi a tutti i fornitori aderenti al sistema. Le librerie che desiderano ricevere i dati di disponibilità a magazzino devono innanzitutto prelevare l anagrafica completa disponibile sul server ftp di Arianna. Successivamente, con cadenza quotidiana, devono scaricare dalla propria cartella sul server ftp il messaggio Disponibilità a magazzino inviato da Arianna + e importarlo per aggiornare la propria base dati. Utilizzando i dati trasmessi da Arianna +, la libreria può verificare l effettiva disponibilità dei prodotti a magazzino e, di conseguenza, inviare ordini ragionevolmente evadibili. La libreria può ricevere, a scelta, la disponibilità di tutti i magazzini oppure dei soli magazzini che servono la propria provincia. La base dati completa è sempre disponibile. In caso di necessità, previo contatto con la segreteria operativa Arianna, la libreria può riallineare i dati di disponibilità a magazzino presenti sul proprio gestionale con quelli di Arianna Il messaggio ONIX di informazioni sul prodotto Arianna + offre alle librerie la possibilità di ricevere dati bibliografici e catalografici di dettaglio mediante il messaggio ONIX di Informazioni sul prodotto. Si tratta di un formato standard per la trasmissione di dati bibliografici sviluppato da EDItEUR. I dati sono relativi a prodotti librari in commercio, di prossima pubblicazione o usciti di catalogo nell ultimo anno dotati di EAN e sono estratti da Alice, il Catalogo dei libri in commercio, fuori catalogo e di prossima pubblicazione gestito da Informazioni Editoriali. Le librerie che desiderano ricevere queste informazioni devono innanzitutto scaricare dal server ftp di Arianna l anagrafica completa e successivamente, con cadenza quotidiana, scaricare dalla propria cartella sul server ftp il messaggio ONIX di Informazioni sul prodotto inviato da Arianna + e importarlo per aggiornare la propria base dati. La base dati completa è sempre disponibile. In caso di necessità, previo contatto con la segreteria operativa Arianna, la libreria può riallineare le anagrafiche presenti sul proprio gestionale con quelle di Arianna Le CLiP di Arianna + CLiP è l'acronimo di Catalogo Libri e Prodotti, la nuova base dati di Informazioni Editoriali nata dall integrazione dei dati bibliografici e catalografici di Alice con i dati logistico-commerciali di Arianna. Gli utenti di Arianna+ possono importare i dati delle CLiP trasmessi attraverso i messaggi Catalogo prodotti (PRICAT), Disponibilità a magazzino (STKRPT) e Informazioni sul prodotto (ONIX) direttamente nel proprio sistema gestionale. Le CLiP sono disponibili in quattro "taglie" (XS, S, L, XL) che si differenziano tra loro per il numero di record e/o per il numero di informazioni contenute. Arianna + - Guida allo sviluppo per le software house pag. 24/66

25 Per l elenco completo dei campi di ricerca e di visualizzazione presenti nelle due versioni si rinvia alla documentazione disponibile sul sito (sezione Info). Per maggiori informazioni si rinvia all Allegato 2 - Formati disponibili per le CLiP, all Allegato 3 - Informazioni minime trasmesse nel messaggio Catalogo prodotti, all Allegato 4 - Caratteristiche del messaggio Catalogo prodotti delle CLiP L e XL e all Allegato 5 - Caratteristiche dei dati trasmessi nei messaggi Catalogo prodotti e ONIX-Informazioni sul prodotto delle CLiP XL. Arianna + - Guida allo sviluppo per le software house pag. 25/66

26 7 IL CICLO DELL ORDINE In Arianna + i partecipanti possono scambiare messaggi relativi a tutte le fasi del ciclo dell ordine. Di seguito viene fornita una descrizione sintetica delle informazioni che devono/possono essere trasmesse in ciascun messaggio e una descrizione del flusso informativo tra i vari soggetti coinvolti. 7.1 I messaggi del ciclo dell ordine Ordine Questo messaggio è disponibile sia in formato XML che in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Informazioni obbligatorie. Riferimenti ad altri documenti Termini di consegna e di evasione dell ordine, gestione delle prenotazioni Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero e data dell offerta commerciale. Numero della promozione e data di inizio e fine. Numero di cedola novità e data di inizio e fine. Numero di autorizzazione dell agente (per autorizzare condizioni non standard presenti nell ordine). Numero dell ordine assegnato dal fornitore. Numero dell ordine attribuito dall acquirente (nel caso di ordini inoltrati dall agente al fornitore). Richiesta di consegna merce non prima di/alla/entro la data specificata. Richiesta di fornire il disponibile e cancellare il resto. Richiesta di fornire il disponibile e mettere in prenotazione il resto. Richiesta di annullare l ordine se non può essere evaso completamente. Nei messaggi di testo possono essere indicati solo il riferimento al numero di messaggio originale e il numero di autorizzazione dell agente. I riferimenti a cedola e promozione possono essere indicati solo a livello di linea. Nei messaggi di testo non sono presenti. La richiesta di prenotazione può essere indicata solo a livello di linea. Arianna + - Guida allo sviluppo per le software house pag. 26/66

27 INFORMAZIONE DESCRIZIONE NOTE Identificazione delle parti Termini e mezzi di pagamento, richiesta di merce in conto deposito. Gestione degli sconti e delle spese. Modalità di trasporto. Informazioni aggiuntive Acquirente, Fornitore, Agente/rappresentante del fornitore. Chi fa l ordine (se diverso dall acquirente), Ufficio centrale dell acquirente, Agente/rappresentante dell acquirente. Mittente originale dell ordine (inserito da Arianna + nei singoli ordini smistati ai fornitori). Destinatario della merce e della fattura (se diversi dall ordinante). Arianna + (fornitore di servizi a valore aggiunto). Parti a cui inviare la notifica (inserito da Arianna + in base al profilo utente nel database dei partecipanti). Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, codice fiscale, partita IVA), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). Termini di pagamento non standard. Pagamenti a rate. Conto deposito. Specificazione che tutti i titoli ordinati non sono ancora pubblicati o che sono remainder. Richiesta di sconti o di ripartizione delle spese espressi come quantità, percentuale, importo assoluto o importo proporzionale. Modalità di trasporto delle merci (eventualmente collegate a diversi luoghi di consegna). Note di testo libero o informazioni codificate convenute tra le parti. L identificazione dell acquirente è obbligatoria. Nei messaggi in formato testo è possibile indicare solo l EAN Location Code della parte senza i dati anagrafici in chiaro. Non è possibile specificare il destinatario della fattura e non viene indicato l EAN della parte che riceve la notifica. Nel formato di testo possono essere indicati solo Termini di pagamento e Conto deposito in maniera semplificata.. Nei messaggi di testo non sono presenti. Gli sconti possono essere indicati in maniera semplificata solo a livello di linea. Nei messaggi di testo non sono presenti. DETTAGLIO (informazioni valide per la singola linea) Nei messaggi di testo non sono presenti. Identificazione della linea e del prodotto Identificazione tramite EAN. Indicazione di eventuali codici aggiuntivi (per es. codici interni di acquirente o fornitore). Indicazione di prodotti accettabili come sostituti. Indicazione di rifiuto di prodotti sostitutivi. L identificazione del prodotto è obbligatoria. Nel formato testo non sono gestiti né i codici aggiuntivi né i prodotti sostitutivi. Quantità Quantità ordinata e gratuita. L indicazione della quantità è obbligatoria. Arianna + - Guida allo sviluppo per le software house pag. 27/66

28 INFORMAZIONE DESCRIZIONE NOTE Termini di consegna e di evasione della linea d ordine, gestione delle prenotazioni Richiesta di consegna merce non prima di/alla/entro la data specificata. Richiesta di fornire il disponibile e cancellare il resto. Richiesta di fornire il disponibile e mettere in prenotazione il resto. Specificazione che il titolo ordinato non è ancora pubblicato o che è remainder. Nel formato testo può essere specificata solo la richiesta di prenotazione. Riferimenti ad altri documenti Il luogo di consegna e lo split order Inserimento di un riferimento alla linea d ordine corrente. Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero e data dell offerta commerciale o di una linea dell offerta commerciale. Numero di autorizzazione dell agente (per autorizzare condizioni non standard presenti nell ordine). Numero dell ordine assegnato dal fornitore. Numero dell ordine attribuito dal cliente (nel caso di ordini inoltrati dall agente al fornitore). Numero della promozione e data di inizio e fine. Numero di cedola novità e data di inizio e fine. Indicazione di un luogo di consegna diverso da quello indicato in testata. Nel caso di ordini multidestinazione, indicazione di luogo, quantità e data non prima di/alla/entro la quale si richiede di consegnare la merce. Nel formato testo possono essere indicati solo i riferimenti al numero di promozione e alla cedola novità. Nei messaggi di testo non sono presenti. Gestione degli sconti e delle spese. Richiesta di sconti o di ripartizione delle spese espressi come quantità, percentuale, importo assoluto o importo proporzionale. Nel formato testo possono essere indicati gli sconti in maniera semplificata. Indicazione del prezzo Prezzo di catalogo o prezzo promozionale. Informazioni aggiuntive Note di testo libero o informazioni codificate convenute tra le parti. SOMMARIO (informazioni di riepilogo) Nei messaggi di testo non sono presenti. Informazioni di riepilogo Numero di linee, numero di prodotti ordinati. Il numero di linee è obbligatorio. Nei messaggi di testo non è presente il numero di prodotti ordinati. Per informazioni di dettaglio sul messaggio Ordini si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Arianna + - Guida allo sviluppo per le software house pag. 28/66

29 Guida di riferimento (ROrders-Xml200.pdf) e Guida all utilizzo (UOrders-Xml200.pdf) al messaggio Ordini in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. Guida al messaggio Ordini in formato testo contenuta nella più generale Guida ai messaggi TXT (Messaggi_TXT.pdf) Risposta all ordine Questo messaggio è disponibile sia in formato XML che in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale, variazione o copia) del documento. Informazioni obbligatorie. Stato dell ordine Riferimenti ad altri documenti Termini di consegna dell ordine Codice di risposta all ordine (accettato con variazioni, accettato senza variazioni, non ancora processato, autorizzato dall agente, elaborato da Arianna +, rifiutato). Causale del rifiuto o della modifica dell intero ordine (per es. importo minimo non raggiunto, promozione scaduta, termini di pagamento non standard non accettati ecc.). Numero e data dell ordine cui si risponde (attribuito dall acquirente, dall agente o dal fornitore). Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero di autorizzazione dell agente (per autorizzare condizioni non standard presenti nell ordine). Numero di una precedente risposta all ordine, numero di avviso di spedizione. Numero della promozione e data di inizio e fine. Numero di cedola novità e data di inizio e fine. Consegna merce promessa non prima di/alla/entro la data specificata o differita alla data specificata. L indicazione del codice di risposta all ordine è obbligatorio. Nel messaggio TXT può essere specificato solo il riferimento all ordine. Nel messaggio XML il riferimento all ordine cui si dà risposta può essere specificato a livello di testata o di singola linea. Nei messaggi di testo non sono presenti. Arianna + - Guida allo sviluppo per le software house pag. 29/66

30 INFORMAZIONE DESCRIZIONE NOTE Identificazione delle parti Termini e mezzi di pagamento, invio di merce in conto deposito. Gestione degli sconti e delle spese. Modalità di trasporto Acquirente, Fornitore, Agente/rappresentante del fornitore. Chi ha effettuato l ordine (se diverso dall acquirente), Ufficio centrale dell acquirente, Agente/rappresentante dell acquirente. Destinatario della merce e della fattura (se diversi dall ordinante). Responsabile della spedizione e del trasporto. Arianna + (fornitore di servizi a valore aggiunto). Parti a cui inviare la notifica (inserito da Arianna + in base al profilo utente nel database dei partecipanti). Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, codice fiscale, partita IVA), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). Termini di pagamento non standard. Pagamenti a rate. Conto deposito. Possono essere usati in caso di ordine accettato con modifiche per specificare le condizioni applicate dal fornitore. Indicazione di sconti o di ripartizione delle spese espressi come quantità, percentuale, importo assoluto o importo proporzionale. Possono essere usati in caso di ordine accettato con modifiche per specificare le condizioni applicate dal fornitore. Modalità di trasporto delle merci. Possono essere usati in caso di ordine accettato con modifiche per specificare le condizioni applicate dal fornitore. L identificazione dell acquirente è obbligatoria. Nei messaggi in formato testo è possibile indicare solo l EAN Location Code della parte senza i dati anagrafici in chiaro. Non è possibile specificare il destinatario della fattura o della merce né il responsabile della spedizione o del trasporto e non viene indicato l EAN della parte che riceve la notifica. Nei messaggi di testo non sono presenti. Nei messaggi di testo non sono presenti. Nei messaggi di testo non sono presenti. Informazioni aggiuntive Note di testo libero o informazioni codificate convenute tra le parti. DETTAGLIO (informazioni valide per la singola linea) Nei messaggi di testo non sono presenti. Identificazione della linea e del prodotto Identificazione tramite EAN. Indicazione di eventuali codici aggiuntivi (per es. codici interni di acquirente o fornitore). Indicazione del prodotto ordinato di cui viene fornito un sostituto. L identificazione del prodotto è obbligatoria. Nel formato testo non sono gestiti né i codici aggiuntivi né i prodotti sostitutivi. Arianna + - Guida allo sviluppo per le software house pag. 30/66

31 INFORMAZIONE DESCRIZIONE NOTE Quantità Stato della linea d ordine Riferimenti ad altri documenti Quantità ordinata, già spedita, fatturata, in backorder, allocata per l acquirente, cancellata, gratuita, in sostituzione, minima e massima ordinabile. Codice di risposta alla linea d ordine (accettata, non accettata, accettata con modifiche, aggiunta, annullata, accettata e inoltrata al fornitore, non accettata e non inoltrata al fornitore). Causale della modifica o del rifiuto della linea d ordine (per es. prodotto fuori catalogo, esaurito, ordinabile solo presso l editore ecc.). Inserimento di un riferimento alla linea di risposta all ordine corrente. Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero e data di: offerta commerciale, ordine (attribuito da acquirente, fornitore o agente), precedente risposta all ordine, avviso di spedizione o di una loro linea. Numero della promozione e data di inizio e fine. Numero di cedola novità e data di inizio e fine. Numero di autorizzazione dell agente (per autorizzare condizioni non standard presenti nell ordine). La quantità ordinata è obbligatoria. Nei messaggi di testo non sono gestite la quantità fatturata, in sostituzione, minima e massima. Il codice di risposta alla linea d ordine è obbligatorio. Nei messaggi di testo non sono presenti. Termini di consegna e di evasione della linea d ordine Il luogo di consegna e lo split order Gestione degli sconti e delle spese Consegna merce promessa non prima di/alla/entro la data specificata. Data di disponibilità prevista. Data di pubblicazione prevista. Possono essere usati in caso di linea d ordine accettata con modifiche per specificare le condizioni applicate dal fornitore. Indicazione di un luogo di consegna diverso da quello indicato in testata. Nel caso di ordini multidestinazione, indicazione di luogo, quantità e data non prima di/alla/entro la quale si promette di consegnare/spedire la merce. Possono essere usati in caso di linea d ordine accettata con modifiche per specificare le condizioni applicate dal fornitore. Indicazione di sconti o di ripartizione delle spese espressi come quantità, percentuale, importo assoluto o importo proporzionale. Possono essere usati in caso di linea d ordine accettata con modifiche per specificare le condizioni applicate dal fornitore. Nei messaggi di testo non sono presenti. Nei messaggi di testo non sono presenti. Nei messaggi di testo non sono presenti. Arianna + - Guida allo sviluppo per le software house pag. 31/66

32 INFORMAZIONE DESCRIZIONE NOTE Indicazione del prezzo Informazioni aggiuntive Prezzo applicato dal fornitore. Prezzo di catalogo e prezzo promozionale. Note di testo libero o informazioni codificate convenute tra le parti. SOMMARIO (informazioni di riepilogo) Nel messaggio di testo è possibile indicare solo il prezzo applicato dal fornitore. Nei messaggi di testo non sono presenti. Informazioni di riepilogo Numero di linee, numero di prodotti ordinati. Il numero di linee è obbligatorio. Nei messaggi di testo non è presente il numero di prodotti ordinati. Per informazioni di dettaglio sul messaggio Risposta all ordine si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (ROrdrps-Xml200.pdf) e Guida all utilizzo (UOrdrsp-Xml200.pdf) al messaggio Risposta all ordine in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. Guida al messaggio Risposta all ordine in formato testo contenuta nella più generale Guida ai messaggi TXT (Messaggi_TXT.pdf) Avviso di spedizione Questo messaggio è disponibile sia in formato XML che in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Informazioni obbligatorie. Riferimenti ad altri documenti Date correlate alla spedizione Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero dell ordine (attribuito dall acquirente, dall agente o dal fornitore), numero di risposta all ordine. Numero di un precedente avviso di spedizione, di fattura, di avviso di reso. Numero del documento di trasporto (attribuito dal trasportatore o dal creatore del messaggio), della spedizione (attribuito dal trasportatore), della transazione (attribuito dal fornitore), di riferimento postale, di lista di prelievo, interno di magazzino, ulteriore numero di riferimento. Data di spedizione. Consegna alla/entro/non prima della data specificata. Nei messaggi di testo non sono presenti. La data di spedizione è obbligatoria. Nei messaggi di testo non sono gestite le date di consegna. Arianna + - Guida allo sviluppo per le software house pag. 32/66

33 INFORMAZIONE DESCRIZIONE NOTE Identificazione delle parti Acquirente, Fornitore, Agente/rappresentante del fornitore. Chi ha effettuato l ordine (se diverso dall acquirente), Ufficio centrale dell acquirente. Destinatario della merce e della fattura (se diversi dall ordinante). Responsabile della spedizione e del trasporto. Arianna + (fornitore di servizi a valore aggiunto). Parti a cui inviare la notifica (inserito da Arianna + in base al profilo utente nel database dei partecipanti). Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, codice fiscale, partita IVA), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). L identificazione di fornitore e acquirente è obbligatoria. Nei messaggi di testo, oltre a fornitore e acquirente, è possibile indicare solo il destinatario della merce. Mezzo e spese di trasporto Caratteristiche fisiche e identificazione dell imballo Modalità di spedizione (posta ordinaria, corriere ecc.). Porto franco/porto assegnato. Numero e tipo di contenitori/pacchi. DETTAGLIO (informazioni valide per la singola linea) Nei messaggi di testo non sono presenti. Nei messaggi di testo è possibile indicare solo il numero di colli. Identificazione della linea e del prodotto Identificazione tramite EAN. Descrizione testuale (descrizione primaria del prodotto, edizione, collana, tipo prodotto, numero volume, descrizione non strutturata) del prodotto in consegna. Indicazione di eventuali codici aggiuntivi (per es. codici interni di acquirente o fornitore). Identificazione del prodotto originariamente ordinato e sostituito con quello in spedizione. L identificazione del prodotto è obbligatoria. Nel formato testo non sono gestiti né i codici aggiuntivi né il prodotto originariamente ordinato. Dimensioni fisiche, prezzo e quantità in spedizione Peso, altezza, spessore, larghezza Prezzo applicato dal fornitore. Prezzo di catalogo e prezzo promozionale. Quantità in spedizione. Quantità cancellata, spedita d ufficio, gratuita, ordinata, precedentemente spedita, resa, in backorder. La quantità in spedizione è obbligatoria. Nel formato testo non sono gestite altre informazioni oltre alla quantità in spedizione. Arianna + - Guida allo sviluppo per le software house pag. 33/66

34 INFORMAZIONE DESCRIZIONE NOTE Riferimenti ad altri documenti Informazioni aggiuntive Inserimento di un riferimento alla linea di avviso di spedizione corrente. Numero e data dell ordine (assegnato dall acquirente, dal fornitore, dall agente) o di una linea d ordine. Numero di riferimento assegnato dall acquirente, Numero di promozione e di cedola novità. Numero e data di: risposta all ordine, precedente avviso di spedizione, richiesta di autorizzazione al reso, istruzioni per il reso, avviso di reso, nota di credito, fattura o di una loro linea. Numero identificativo esterno al pacco, di autorizzazione. Note di testo libero o informazioni codificate convenute tra le parti. Nei messaggi di testo non sono presenti. Nei messaggi di testo non sono presenti. SOMMARIO (informazioni di riepilogo) Informazioni di riepilogo Numero di linee, numero di prodotti in spedizione. Il numero di linee è obbligatorio. Nei messaggi di testo non è presente il numero di prodotti in spedizione. Per informazioni di dettaglio sul messaggio Avviso di spedizione si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RDesadvSXml200.pdf) e Guida all utilizzo (UDesadvSXml200.pdf) al messaggio Avviso di spedizione in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. Guida al messaggio Avviso di spedizione in formato testo contenuta nella più generale Guida ai messaggi TXT (Messaggi_TXT.pdf) Fattura, Nota di debito, Nota di credito Questi messaggi sono disponibili solo in formato XML. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (trasmissione aggiuntiva o copia) del documento. Tipo di documento (fattura, nota di debito, nota di credito). Informazioni obbligatorie. Arianna + - Guida allo sviluppo per le software house pag. 34/66

35 INFORMAZIONE DESCRIZIONE NOTE Riferimenti ad altri documenti Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Identificazione delle parti Indicazione della valuta, termini di pagamento Indicazione di sconti e spese Note fiscali e altre informazioni aggiuntive Identificazione della linea e del prodotto Numero e data d ordine (attribuito dall acquirente, dal fornitore, dall agente), di risposta all ordine, di avviso di spedizione, di istruzioni per il reso, di avviso di reso, di fattura, di nota di debito, di nota di credito. Numero del documento correlato, della transazione (attribuito dall acquirente o dal fornitore), del documento relativo alle condizioni di vendita, dello scontrino fiscale, codice identificativo di una zona commerciale. Acquirente, Fornitore, Destinatario della fattura/nota di debito/nota di credito. Società di servizi, Sottounità interna. Parte a cui inviare la notifica. Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, numero di partita IVA, registro imprese, REA, capitale sociale ecc.), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). Unità monetaria utilizzata nella fattura. Pagamenti a rate o in un unica soluzione. Importo e percentuale della rata. Scadenza dei termini di pagamento. Indicazione di sconti o spese espressi come percentuale o importo assoluto. Note fiscali libere. Note fiscali codificate (contributo CONAI assolto, esente da bollo). DETTAGLIO (informazioni valide per la singola linea) Identificazione tramite EAN. Descrizione testuale (descrizione primaria del prodotto, edizione, collana, tipo prodotto, numero volume, descrizione non strutturata) del prodotto fatturato. Indicazione di eventuali codici aggiuntivi (per es. codici interni di acquirente o fornitore). Solo nella Nota di debito e nella Nota di credito è obbligatorio il riferimento alla Fattura. L identificazione di acquirente, fornitore e destinatario del documento è obbligatoria. L identificazione del prodotto è obbligatoria. Quantità Quantità fatturata, resa, gratuita. La quantità fatturata è obbligatoria. Prezzo e IVA Prezzo al dettaglio o al rivenditore (incluse o escluse tasse, escluse spese e costi). Tipo, categoria e aliquota di imposta applicata, esenzioni, esclusioni e qualsiasi altro caso di regime fiscale. L indicazione del prezzo e delle imposte è obbligatorio. Arianna + - Guida allo sviluppo per le software house pag. 35/66

36 INFORMAZIONE DESCRIZIONE NOTE Indicazione di sconti e spese Note fiscali, sequenza di calcolo dello sconto e altre informazioni aggiuntive Indicazione di sconti o spese espressi come percentuale o importo assoluto. Note fiscali libere. Note fiscali codificate (contributo CONAI assolto, esente da bollo). Riferimenti ad altri documenti Inserimento di un riferimento alla linea di fattura/nota di debito/nota di credito corrente. Importi totali di linea Riferimento a numero/data del messaggio o a una linea del messaggio: ordine (attribuito dall acquirente, dal fornitore, dall agente), risposta all ordine, avviso di spedizione, istruzioni per il reso, avvisi di reso, fattura, nota di debito, nota di credito. Totale lordo, totale lordo defiscalizzato, totale riaccredito IVA, totale netto, totale sconti e spese. SOMMARIO (informazioni di riepilogo) L indicazione del totale di linea è obbligatorio. Totali riassuntivi di fattura Subtotali IVA Totale righe di fattura, Totale abbuoni/addebiti di livello generale, Totale netto fattura, Totale IVA, Totale fattura, Totale anticipato, Totale da pagare a saldo, Totale merce. Imponibile e imposta per le differenti aliquote IVA (subtotali in piede fattura). Totale netto fattura, Totale IVA e Totale da pagare a saldo sono obbligatori. Totali di spese e sconti Abbuoni/addebbiti raggruppati per tipologia. Totali riassuntivi di controllo Numero di linee, numero di prodotti fatturati. Il numero di linee è obbligatorio. Per informazioni di dettaglio sul messaggio Fattura/Nota di debito/nota di credito si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RInvoic-Xml200.pdf) e Guida all utilizzo (UInvoic-Xml200.pdf) al messaggio Fattura/Nota di debito/nota di credito in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. 7.2 Il flusso informativo tra i soggetti coinvolti Tipicamente il ciclo dell ordine si compone di quattro fasi: 1. l acquirente invia un ordine a un fornitore (distributore, grossista, editore); 2. il fornitore risponde all acquirente nel più breve tempo possibile indicando quali linee dell ordine verranno evase e quali no, specificandone in tal caso il motivo; 3. al momento della spedizione delle merci, il fornitore invia un avviso di spedizione con i dettagli dei prodotti in consegna; 4. su base periodica, il fornitore invia all acquirente la fattura con il dettaglio dei prodotti forniti di cui si richiede il pagamento. Il ciclo dell ordine previsto in Arianna + è molto simile a quello appena descritto, con alcune particolarità: Arianna + - Guida allo sviluppo per le software house pag. 36/66

37 l acquirente può inviare un ordine indistinto ad Arianna +, ossia un ordine contenente prodotti distribuiti da fornitori diversi. Arianna + provvede a elaborare le linee d ordine e comunica il risultato dell elaborazione (ordine accettato in tutto o in parte oppure rifiutato) al mittente mediante un messaggio di Risposta all ordine, contenente il dettaglio delle eventuali linee scartate. Arianna + provvede poi allo smistamento delle linee d ordine ai distributori esclusivi, generando tanti ordini quanti sono i differenti distributori. A questo punto, il ciclo riprende regolarmente come descritto sopra (fasi 2-3-4) con l invio da parte del fornitore di risposta all ordine, avviso di spedizione e fattura. [FUNZIONALITÀ NON ANCORA DISPONIBILE] l acquirente può inviare un ordine diretto a un agente (per es. per ordinare novità e/o per richiedere condizioni particolari non standard). L agente può accettare o meno le richieste dell acquirente che viene informato dell esito del suo ordine mediante una risposta all ordine inviata dall agente. Se l ordine viene rifiutato, il ciclo si chiude. Se l ordine viene accettato, si possono verificare due casi: l agente nella risposta all ordine comunica all acquirente un codice di autorizzazione, e l acquirente invia l ordine al distributore inserendo tale codice; il ciclo dunque riparte dalla fase 1 e prosegue regolarmente fino alla fase 4. l agente inoltra l ordine ricevuto dall acquirente al fornitore, inserendo un codice di autorizzazione. Il ciclo prosegue dalla fase 2, con la peculiarità che la risposta all ordine viene inviata dal fornitore all agente e in copia all acquirente. il fornitore può non essere in grado di fornire immediatamente al mittente dell ordine i dettagli sull evadibilità delle singole linee. In Arianna + è pertanto ammessa una prima risposta all ordine semplificata, nella quale il fornitore comunica semplicemente che l ordine è stato preso in carico. La risposta all ordine completa potrà essere inviata in un secondo momento, anche contestualmente all avviso di spedizione Fase 1: l invio dell ordine L ordine indistinto e la risposta di Arianna + Un ordine indistinto è caratterizzato da due elementi: ha come destinatario l agenzia Arianna può contenere linee d ordine di prodotti distribuiti da fornitori diversi Il mittente può essere l acquirente, il suo ufficio centrale, il suo buyer oppure un promotore. Se il mittente dell ordine è diverso dall acquirente, il sistema Arianna + provvede automaticamente a inviare copia dell ordine all acquirente. Ricevuto il messaggio, l agenzia Arianna: elabora l ordine, scartando le linee nel caso in cui: il prodotto o il produttore non sia presente nel proprio archivio il prodotto non sia ordinabile non esista un distributore esclusivo per quel prodotto nella provincia dell acquirente invia al mittente dell ordine un messaggio di Risposta all ordine in cui viene comunicato il risultato dell elaborazione, che può essere: ordine elaborato da Arianna +, nel caso in cui le linee d ordine siano state accettate in tutto o in parte ordine non accettato, nel caso in cui tutte le linee siano state rifiutate Arianna + - Guida allo sviluppo per le software house pag. 37/66

38 Se il mittente dell ordine è diverso dall acquirente, il sistema Arianna + provvede automaticamente a inviare copia della risposta all ordine all acquirente. Nella sezione di dettaglio, vengono specificate le linee rifiutate e il motivo del loro rigetto che può essere: prodotto non ordinabile prodotto non disponibile nella provincia dell acquirente prodotto non gestito in Arianna + editore non gestito in Arianna + crea tanti ordini quanti sono i distributori esclusivi dei prodotti presenti nell ordine indistinto e li inoltra ai fornitori, specificando in ciascuno di essi il mittente originale dell ordine indistinto, al quale il fornitore dovrà indirizzare la propria risposta all ordine L ordine diretto al fornitore L ordine diretto viene indirizzato dal mittente a uno specifico fornitore (distributore esclusivo, grossista, editore) e a questi trasmesso tramite Arianna +. Il mittente può essere l acquirente, il suo ufficio centrale, il suo buyer oppure un promotore mentre il destinatario è sempre il fornitore. Se il mittente dell ordine è diverso dall acquirente, il sistema Arianna + provvede automaticamente a inviare copia dell ordine all acquirente. La caratteristica principale di un ordine diretto è che l agenzia Arianna non effettua controlli di merito sulle linee d ordine: se non ci sono errori formali, la linea d ordine viene trasmessa al fornitore così com è, senza alcuna verifica sull esistenza del prodotto ordinato nel proprio archivio né sul suo stato di ordinabilità. Il ciclo dell ordine prosegue dunque direttamente alla fase L ordine diretto all agente e la risposta dell agente [FUNZIONALITÀ NON ANCORA DISPONIBILE] Caso particolare dell ordine diretto è l ordine all agente, tipicamente inviato per ordinare delle novità e/o per ordinare prodotti a condizioni particolari, diverse dallo standard vigente tra acquirente e fornitore. In questo tipo di ordine il mittente può essere l acquirente, il suo ufficio centrale o il suo buyer mentre il destinatario è sempre l agente del fornitore. Se il mittente dell ordine è diverso dall acquirente, il sistema Arianna + provvede automaticamente a inviare copia dell ordine all acquirente. Ricevuto il messaggio, l agente valida l ordine oppure lo respinge, in ogni caso ne dà comunicazione al mittente mediante un messaggio di Risposta all ordine. Se il mittente dell ordine è diverso dall acquirente, il sistema Arianna + provvede automaticamente a inviare copia della risposta all ordine all acquirente. Non è prevista l accettazione parziale di un ordine diretto all agente e non è richiesto, nemmeno in caso di rifiuto, l inserimento della sezione di dettaglio del messaggio. Se l ordine è stato rifiutato, il ciclo si chiude. Eventuali correzioni alle richieste dell acquirente daranno origine a un nuovo messaggio e dunque a un nuovo ordine all agente. Se l ordine è stato accettato, l agente può procedere in due maniere: comunicare nella risposta all ordine al mittente dell ordine un codice di autorizzazione. Così facendo il ciclo dell ordine si interrompe e se ne apre uno nuovo: l acquirente, infatti, dovrà inviare al fornitore un nuovo ordine (uguale a quello inviato all agente) contenente il codice di Arianna + - Guida allo sviluppo per le software house pag. 38/66

39 autorizzazione, così che il fornitore sappia che le condizioni non standard presenti nell ordine sono state autorizzate dall agente. aggiungere il proprio codice di autorizzazione all ordine e inoltrarlo al fornitore. In realtà si tratta a tutti gli effetti di un nuovo ordine con un nuovo numero assegnato dall agente e con il riferimento al numero d ordine originale. Inoltrato il messaggio, il ciclo dell ordine continua regolarmente con la fase 2 di risposta all ordine del fornitore. Il sistema Arianna + provvede automaticamente a inviare copia dell ordine inoltrato dall agente al mittente dell ordine originale e, se diverso da quest ultimo, all acquirente Fase 2: la risposta all ordine del fornitore In un flusso ideale, il fornitore risponde in tempo breve al mittente dell ordine comunicandogli quali linee verranno evase subito, quali verranno messe in prenotazione o cancellate ecc. Nella realtà, tuttavia, può capitare che un fornitore non sia in grado di dare subito una risposta di merito rispetto alle linee d ordine. Poiché è importante che il fornitore dia comunque un riscontro al mittente che l ordine è stato preso in carico, è previsto l invio di una prima risposta all ordine semplificata. La risposta all ordine semplificata ha queste caratteristiche: è un messaggio originale inviato dal fornitore al mittente dell ordine o, nel caso di ordine smistato al fornitore da Arianna +, al mittente originale dell ordine indistinto. contiene il riferimento all ordine cui dà risposta. è composta dalla sola sezione di testata. il codice di risposta può indicare soltanto che l ordine è stato ricevuto ma non ancora processato. In un momento successivo, anche contestualmente all avviso di spedizione, al fornitore è richiesto l invio della risposta all ordine completa. La risposta all ordine vera e propria ha queste caratteristiche: è un messaggio originale inviato dal fornitore al mittente dell ordine o, nel caso di ordine smistato al fornitore da Arianna +, al mittente originale dell ordine indistinto. contiene il riferimento all ordine cui dà risposta. il codice di risposta può indicare che l ordine è stato: o o o accettato con variazioni accettato senza variazioni rifiutato contiene la sezione di dettaglio in cui vengono indicate le sole linee cancellate o modificate e, opzionalmente, la causale del rifiuto. Qualora intervengano dei cambiamenti allo stato di disponibilità di uno o più prodotti di uno o più ordini ai quali sia già stata data risposta, il fornitore può comunicare tale variazioni inviando un ulteriore risposta all ordine. La risposta all ordine contenente variazioni ha queste caratteristiche: Arianna + - Guida allo sviluppo per le software house pag. 39/66

40 è un messaggio di variazione inviato dal fornitore al mittente dell ordine o, nel caso di ordine smistato al fornitore da Arianna +, al mittente originale dell ordine indistinto. contiene il riferimento all ordine cui dà risposta o in testata (se le linee di cui comunica la variazione fanno parte di uno stesso ordine) o in ciascuna linea di dettaglio (se le linee di cui comunica la variazione fanno parte di ordini diversi). il codice di risposta può indicare soltanto che l ordine è stato accettato con variazioni. contiene la sezione di dettaglio in cui vengono indicate le sole linee cancellate o modificate e, opzionalmente, la causale del rifiuto. In tutti i casi, qualora il destinatario della risposta all ordine sia diverso dall acquirente, il sistema Arianna + provvederà automaticamente a inviare copia del messaggio all acquirente Fase 3: l avviso di spedizione L avviso di spedizione viene di norma inviato dal fornitore all acquirente, a meno che nel file dei partecipanti per quel dato acquirente non sia stato indicato per questo messaggio un destinatario differente. L avviso di spedizione può riguardare merci ordinate in uno o più ordini precedenti. In quest ultimo caso il riferimento agli ordini può essere fornito: a livello di testata, senza collegare direttamente i prodotti e le quantità ai singoli ordini che le hanno generate; a livello di linea, collegando ciascun prodotto allo specifico ordine e, nel caso di uno stesso prodotto presente in più ordini, collegando le diverse quantità di prodotto ai singoli ordini che le hanno generate. Poiché la spedizione può riguardare anche merci ordinate al di fuori del circuito Arianna +, nell avviso di spedizione possono essere presenti prodotti non inseriti nell archivio di Arianna +, identificati con l EAN o mediante una semplice descrizione testuale Fase 4: la fattura La fattura viene di norma inviata dal fornitore all acquirente, a meno che nel file dei partecipanti per quel dato acquirente non sia stato indicato per questo messaggio un destinatario differente. La fattura può riguardare merci ordinate e/o spedite in momenti diversi. In quest ultimo caso il riferimento agli ordini e/o agli avvisi di spedizione può essere fornito: a livello di testata, senza collegare direttamente i prodotti e le quantità ai singoli ordini o alle singole spedizioni; a livello di linea, collegando ciascun prodotto allo specifico ordine e/o spedizione; nel caso di uno stesso prodotto presente in più ordini o in più spedizioni, vanno create per quel prodotto tante linee quante sono le diverse quantità associate a ordini o spedizioni diverse. Poiché la fattura può riguardare anche merci ordinate al di fuori del circuito Arianna +, possono essere presenti prodotti non inseriti nell archivio di Arianna +, identificati con l EAN o mediante una semplice descrizione testuale. Arianna + - Guida allo sviluppo per le software house pag. 40/66

41 8 LA SPEDIZIONE DI MERCI RESE In Arianna + i partecipanti possono scambiare informazioni relative alla spedizione e al ricevimento di merci rese. Di seguito viene fornita una descrizione sintetica delle informazioni che devono/possono essere trasmesse in ciascun messaggio e una descrizione del flusso informativo tra i vari soggetti coinvolti. 8.1 I messaggi di reso Avviso di spedizione di reso Questo messaggio è disponibile solo in formato XML. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Informazioni obbligatorie. Riferimenti ad altri documenti Date correlate alla spedizione Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero dell ordine (attribuito dall acquirente, dall agente o dal fornitore), numero di risposta all ordine. Numero di un precedente avviso di reso, di avviso di spedizione, di fattura. Numero del documento di trasporto (attribuito dal trasportatore o dal creatore del messaggio), della spedizione (attribuito dal trasportatore), della transazione (attribuito dal fornitore), di riferimento postale, di lista di prelievo, interno di magazzino, ulteriore numero di riferimento. Data di spedizione. Informazione obbligatoria. Identificazione delle parti Acquirente, Fornitore, Agente/rappresentante del fornitore. Chi ha effettuato l ordine (se diverso dall acquirente), Ufficio centrale dell acquirente. Destinatario della merce (se diverso dal fornitore). Destinatario della nota di credito (se diverso dall'acquirente). Responsabile della spedizione e del trasporto. Arianna + (fornitore di servizi a valore aggiunto). Parti a cui inviare la notifica (inserito da Arianna + in base al profilo utente nel database dei partecipanti). Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, codice fiscale, partita IVA), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). L identificazione di fornitore e acquirente è obbligatoria. Arianna + - Guida allo sviluppo per le software house pag. 41/66

42 INFORMAZIONE DESCRIZIONE NOTE Mezzo e spese di trasporto Causale del reso Caratteristiche fisiche e identificazione dell imballo Modalità di spedizione (posta ordinaria, corriere ecc.). Porto franco/porto assegnato. Motivo per cui la merce viene resa (reso di pubblicazioni fuori catalogo, di merce difettosa o danneggiata ecc.) Numero e tipo di contenitori/pacchi. Dimensioni. DETTAGLIO (informazioni valide per la singola linea) Opzionale, ma se la causale non è indicata in testata, allora deve obbligatoriamente essere indicata in ciascuna linea di dettaglio. Identificazione della linea e del prodotto Dimensioni fisiche, prezzo e quantità in spedizione Identificazione tramite EAN. Descrizione testuale (descrizione primaria del prodotto, edizione, collana, tipo prodotto, numero volume, descrizione non strutturata) del prodotto in consegna. Indicazione di eventuali codici aggiuntivi (per es. codici interni di acquirente o fornitore). Identificazione del prodotto originariamente ordinato e sostituito con quello in spedizione. Peso, altezza, spessore, larghezza Quantità in spedizione. Quantità resa. L identificazione del prodotto è obbligatoria. La quantità in spedizione è obbligatoria. Causale del reso Motivo per cui la merce viene resa (reso di pubblicazioni fuori catalogo, di merce difettosa o danneggiata ecc.) Opzionale, ma se la causale non è indicata in testata, allora deve obbligatoriamente essere indicata in ciascuna linea di dettaglio. Riferimenti ad altri documenti Totali di linea Riferimenti alla confezione e informazioni aggiuntive Inserimento di un riferimento alla linea di avviso di reso corrente. Numero e data dell ordine (assegnato dall acquirente, dal fornitore, dall agente) o di una linea d ordine. Numero di riferimento assegnato dall acquirente. Numero e data di: risposta all ordine, avviso di spedizione, nota di credito o di una loro linea. Numero identificativo esterno al pacco, di autorizzazione. Importo totale di linea. Totale lordo di linea, totale lordo di linea al netto dell IVA, totale dell IVA di linea. Riferimenti alla confezione contenente il prodotto descritto nella linea corrente. Note di testo libero o informazioni codificate convenute tra le parti. SOMMARIO (informazioni di riepilogo) L importo totale di linea è obbligatorio. Arianna + - Guida allo sviluppo per le software house pag. 42/66

43 INFORMAZIONE DESCRIZIONE NOTE Informazioni di riepilogo Importo totale del messaggio. Ulteriori importi totali codificati (totale lordo, totale lordo al netto dell IVA, totale dell IVA). Peso complessivo. Numero di linee, numero di prodotti in spedizione. Il numero di linee è obbligatorio. Per informazioni di dettaglio sul messaggio Avviso di spedizione di reso si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RDesadvRXml200.pdf) e Guida all utilizzo (UDesadvRXml200.pdf) al messaggio Avviso di reso in formato XML, contenute nel file Messaggi_XML_Reso.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi_Reso.zip Avviso di ricevimento di reso Questo messaggio è disponibile solo in formato XML. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Riferimenti ad altri documenti Identificazione delle parti Numero, data, mittente, destinatario e funzione (originale o copia) del documento. Stato della spedizione contenente le merci rese. Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero dell ordine (attribuito dall acquirente, dall agente o dal fornitore), numero di risposta all ordine. Numero di avviso di reso, di avviso di spedizione, di fattura, di nota di credito. Numero del documento di trasporto (attribuito dal trasportatore o da chi invia le merci), di riferimento postale, di lista di prelievo, interno di magazzino, ulteriore numero di riferimento. Acquirente, Fornitore, Agente/rappresentante del fornitore. Chi ha effettuato l ordine (se diverso dall acquirente), Ufficio centrale dell acquirente. Destinatario della merce (se diverso dal fornitore). Destinatario della nota di credito (se diverso dall'acquirente). Responsabile della spedizione e del trasporto. Arianna + (fornitore di servizi a valore aggiunto). Parti a cui inviare la notifica (inserito da Arianna + in base al profilo utente nel database dei partecipanti). Per ciascuna parte è possibile indicare: nome e indirizzo, riferimenti (per es. a codici identificativi interni, codice fiscale, partita IVA), persone da contattare, modalità di comunicazione (telefono, fax, ecc.). Informazioni obbligatorie. L identificazione di fornitore e acquirente è obbligatoria. Arianna + - Guida allo sviluppo per le software house pag. 43/66

44 INFORMAZIONE DESCRIZIONE NOTE Mezzo e spese di trasporto Caratteristiche fisiche e identificazione dell imballo Informazioni di riepilogo Modalità di spedizione (posta ordinaria, corriere ecc.). Porto franco/porto assegnato. Numero e tipo di contenitori/pacchi. Dimensioni. SOMMARIO (informazioni di riepilogo) Peso complessivo. Numero di linee. Il numero di linee è obbligatorio. Per informazioni di dettaglio sul messaggio Avviso di ricevimento di reso si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RRecadvRXml200.pdf) e Guida all utilizzo (URecadvRXml200.pdf) al messaggio Avviso di ricevimento di reso in formato XML, contenute nel file Messaggi_XML_Reso.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi_Reso.zip. 8.2 Il flusso informativo tra i soggetti coinvolti L avviso di spedizione di reso viene trasmesso dalla parte che spedisce le merci da rendere (tipicamente l acquirente) alla parte che le riceve (tipicamente il fornitore o il magazzino del fornitore), allo scopo di fornire informazioni dettagliate relative alle merci spedite, ai tempi e alle modalità di spedizione. L avviso di ricevimento di reso viene trasmesso dalla parte che riceve le merci rese alla parte che le ha spedite, allo scopo di fornire un riscontro dell avvenuta ricezione. Il messaggio conferma semplicemente il ricevimento delle merci rese: nessuna informazione viene fornita relativamente a eventuali discrepanze tra quanto indicato dalla libreria nell avviso di spedizione di reso e quanto effettivamente ricevuto. Arianna + - Guida allo sviluppo per le software house pag. 44/66

45 9 I DATI DI VENDITA Arianna + fornisce un servizio di rilevazione dei dati di vendita e di ridistribuzione delle informazioni verso gli attori della filiera editoriale. Grazie al monitoraggio quotidiano del sell-out, gli editori possono prendere le decisioni relative a ristampe e nuove edizioni, i distributori approvvigionare i propri magazzini in modo da ridurre tempi di giacenza e di consegna della merce e i promotori seguire nel dettaglio le vendite così da poter dialogare con le librerie sulla base di elementi concreti. Rispetto al servizio Arianna +, dunque, il flusso informativo relativo ai dati di vendita è bidirezionale: in ingresso dalle librerie, in uscita verso editori, promotori, distributori e altri soggetti autorizzati. I dati ricevuti vengono verificati a campione dalla redazione di Arianna + che ne controlla la completezza e la congruenza. Di seguito viene fornita una descrizione sintetica delle informazioni che devono/possono essere trasmesse nel messaggio Relazione vendite e una descrizione del flusso informativo tra i vari soggetti coinvolti. 9.1 I messaggi di sell-out Relazione vendite Questo messaggio è disponibile sia in formato XML che in formato testo. INFORMAZIONE DESCRIZIONE NOTE TESTATA (informazioni valide per l intero messaggio) Identificazione del messaggio Identificazione del periodo di rilevazione Riferimenti ad altri documenti Identificazione delle parti Numero, data, mittente, destinatario e funzione (originale, cancellazione, sostituzione o copia) del documento. Giorno iniziale e finale di rilevazione dei dati di vendita. Numero e data del messaggio contenente il documento originale (inserito dall agenzia Arianna). Numero e data di una precedente relazione vendite. Rivenditore. Parte a cui inviare la notifica. Per ciascuna parte è possibile indicare: nome e indirizzo, persone da contattare, modalità di comunicazione (telefono, fax, ecc.). DETTAGLIO (informazioni valide per la singola linea) Informazioni obbligatorie. Informazioni obbligatorie. Nei messaggi di testo può essere inserito solo il numero di una precedente relazione vendite. L identificazione del rivenditore è obbligatoria. Nei messaggi di testo può essere inserito solo l EAN Location Code del rivenditore. Identificazione della giornata di vendita Identificazione della provincia di vendita Identificazione della linea e del prodotto Giornata in cui sono state effettuate le vendite. Sigla della provincia di vendita (nel solo caso di librerie online). Identificazione tramite EAN. Informazione obbligatoria. Informazione opzionale. Informazione obbligatoria. Arianna + - Guida allo sviluppo per le software house pag. 45/66

46 INFORMAZIONE DESCRIZIONE NOTE Quantità, prezzo di listino e valore incassato Quantità venduta o resa dal cliente. Prezzo di listino del prodotto venduto. Totale incassato. L indicazione della quantità è obbligatoria. Nei messaggi di testo non possono essere indicati prezzo e totale incassato. Per informazioni di dettaglio sul messaggio Relazione vendite si rinvia alla documentazione disponibile sul sito Si vedano in particolare: Guida di riferimento (RSlsrpt-Xml200.pdf) e Guida all utilizzo (USlsrpt-Xml200.pdf) al messaggio Relazione vendite in formato XML, contenute nel file Messaggi_XML.zip Schemi XSD e diagrammi HTML, contenuti nel file Schemi.zip. Guida al messaggio Relazione vendite in formato testo contenuta nella più generale Guida ai messaggi TXT (Messaggi_TXT.pdf). 9.2 Il flusso informativo tra i soggetti coinvolti Alle librerie viene richiesto di inviare in un unico messaggio tutti i dati di un intera giornata di vendita, dall apertura alla chiusura della cassa. Viene inoltre chiesto di inviare la Relazione vendite ad Arianna + con frequenza quotidiana. È importante che la libreria non invii i dati di una stessa giornata spezzati in messaggi diversi. I dati di un intera giornata di vendita possono essere inviati anche il giorno immediatamente successivo. Ulteriori dilazioni nell invio sono ammesse solo in caso di festività e chiusure. Qualora la libreria debba inviare i dati relativi a più giornate di vendita, viene richiesto di inserirli in messaggi distinti ossia di creare un messaggio per ciascuna giornata. A campione, i dati ricevuti vengono verificati dalla redazione di Arianna + che ne controlla la completezza e la congruenza. Ogni giorno, in un momento prestabilito al termine del lavoro di verifica, Arianna + invia ai destinatari tanti messaggi Relazione vendite quante sono le librerie che hanno venduto prodotti di competenza del destinatario. I destinatari ricevono esclusivamente i dati relativi ai prodotti di propria competenza o un loro sottoinsieme. All interno del portale ibuk è disponibile il servizio Segnalibro che permette agli utenti, in base al proprio profilo, di ricercare, visualizzare, aggregare e scaricare su file i dati di vendita di propria competenza utilizzando numerosi parametri. Arianna + - Guida allo sviluppo per le software house pag. 46/66

47 10 I SERVIZI WEB DI ARIANNA + I partecipanti di Arianna + possono usufruire di numerosi servizi all interno del portale ibuk ( sviluppato da Informazioni Editoriali. L accesso avviene tramite User ID e password. Il numero di servizi e la loro ampiezza dipende dal tipo di abbonamento sottoscritto dall utente. Per un singolo partecipante (per es. una libreria) possono essere attivate più utenze web con diversi livelli di operatività (per es. un utenza può essere abilitata solo alla ricerca dei titoli e un altra anche all invio di ordini). Di seguito vengono descritti i principali servizi disponibili Ricerche Cercalibro Questo servizio permette di consultare il nuovo Catalogo Libri e Prodotti (CLiP) nato dall integrazione dei dati bibliografici e catalografici di Alice con i dati logistico-commerciali di Arianna. Cercalibro è disponibile in due taglie che permettono l'accesso ai soli dati bibliografici di base del prodotto (L) o, in alternativa, ai dati bibliografici e catalografici completi (XL). Per l elenco completo dei campi di ricerca e di visualizzazione presenti nelle due versioni si rinvia alla documentazione disponibile sul sito (sezione Info) Anagrafiche soggetti e aggiornamento dei dati Gli utenti possono effettuare ricerche e visualizzare i dati anagrafici dei principali soggetti della filiera editoriale: editori, promotori, distributori, grossisti, librerie ecc. Ogni utente può accedere online ai propri dati anagrafici e inviare una richiesta di modifica. Gli editori (o altri soggetti da questi autorizzati) hanno inoltre la possibilità di accedere ai record dei propri prodotti presenti nel Catalogo dei libri in commercio e di richiedere la correzione delle informazioni o l aggiunta di nuovi record alla base dati Servizi Arianna In questa sezione è possibile accedere ad alcuni servizi di Arianna+, scaricare la documentazione tecnica e leggere le comunicazioni di servizio della segreteria operativa Trovalibro Con il servizio Trovalibro le librerie possono verificare la disponibilità di un titolo presso i magazzini dei fornitori. Arianna + - Guida allo sviluppo per le software house pag. 47/66

48 WebOrdering Il servizio di Web Ordering permette a ogni libreria aderente ad Arianna + di inviare i propri ordini direttamente via Web. Il carrello degli ordini può essere riempito con i prodotti trovati in seguito a una ricerca oppure caricando i dati da un file esterno Segnalibro Questo servizio permette agli utenti autorizzati (tipicamente Editori, Reti promozionali, Distributori e Librerie) di visualizzare i dati di vendita di propria competenza, eventuali statistiche e classifiche generali e aggregazioni di dati utili ai soggetti stessi Servizi per editori, reti promozionali e distributori Statistiche Gli utenti possono utilizzare le Statistiche di Segnalibro per analizzare i propri dati di vendita nelle librerie aderenti al circuito Arianna+. Sono disponibili i dati da gennaio 2009 in poi. I dati possono essere analizzati impostando numerosi parametri di ricerca tra loro combinabili: periodo di vendita, filtri geografici, filtri rivenditore, filtri prodotto. I dati di vendita sono presentati sotto forma di grafici o di tabelle: Grafici rivenditore: diagrammi circolari con l'assorbimento per Tipo libreria, Dimensione e Specializzazione. Grafici geografici: diagrammi circolari con l'assorbimento per Macro area geografica e per Regione. Grafici prodotto: diagrammi circolari con l'assorbimento per Novità/catalogo, Fascia di prezzo, Editore e Collana. Sellout mensile: dati di vendita dell'anno corrente e dei due anni precedenti aggregati su base mensile. Sellout giornaliero: dati di vendita del mese corrente e dei tre mesi precedenti aggregati su base giornaliera. Confronto: confronto tra i dati di vendita omogenei dell'anno corrente e quelli degli anni precedenti, aggregati su base mensile. Sono disponibili solo i dati dei mesi già conclusi Classifiche Gli utenti possono utilizzare le Classifiche di Segnalibro per creare classifiche personalizzate relative ai propri dati di vendita, impostando gli stessi parametri disponibili per le Statistiche. Sono disponibili due differenti classifiche: Classifica (dettaglio giornaliero): sono elencati i titoli più venduti nel periodo di riferimento (il valore predefinito è l'ultima settimana conclusa). È possibile cambiare il periodo di riferimento e creare classifiche con dettaglio giornaliero sui dati del mese corrente e dei tre mesi precedenti. Classifica (dettaglio mensile): sono elencati i titoli più venduti nel periodo di riferimento (il valore predefinito è l'ultimo mese concluso). È possibile cambiare il periodo di riferimento e creare classifiche con dettaglio mensile sui dati da gennaio 2009 in poi. Arianna + - Guida allo sviluppo per le software house pag. 48/66

49 Servizi per le librerie Statistiche Le librerie possono utilizzare le Statistiche di Segnalibro per analizzare i dati di vendita della propria libreria e confrontarli con i dati aggregati di tutte le librerie aderenti al circuito Arianna+. Sono disponibili i dati da gennaio 2011 in poi. I dati possono essere analizzati impostando numerosi parametri di ricerca tra loro combinabili: periodo di vendita, filtri geografici, filtri rivenditore, filtri prodotto. I dati di vendita sono presentati sotto forma di tabelle: Sellout mensile: dati di vendita da gennaio 2011 in poi aggregati su base mensile. Sellout giornaliero: dati di vendita del mese corrente e dei tre mesi precedenti aggregati su base giornaliera. Confronto: confronto tra i dati di vendita dell'anno corrente e degli anni precedenti (dal 2011 in poi), aggregati su base mensile. Sono disponibili solo i dati dei mesi già conclusi Classifiche Le librerie possono utilizzare le Classifiche di Segnalibro per elaborare la lista dei propri libri più venduti in un dato intervallo di tempo, messi in relazione con i titoli più venduti dalle librerie Arianna+, impostando gli stessi parametri disponibili per le Statistiche. Sono disponibili due differenti classifiche: Classifica Libreria: contiene i titoli più venduti dalla libreria nel periodo di riferimento. Classifica A+: i titoli più venduti dall'insieme delle librerie A+ nel periodo di riferimento. Il periodo di riferimento predefinito è l'ultima settimana conclusa, ma è possibile impostare un qualsiasi intervallo di tempo dal 1 gennaio 2011 in avanti Notizie In questa sezione vengono forniti dati e analisi sulla produzione e le vendite del settore editoriale: classifiche settimanali dei libri più venduti, classifiche mensili internazionali, le novità in libreria, gli annunci dei titoli di prossima pubblicazione ecc. Arianna + - Guida allo sviluppo per le software house pag. 49/66

50 11 ALLEGATO 1 - ELENCO DELLE MODIFICHE AL CONTENUTO DEI MESSAGGI IN FASE DI CONVERSIONE 11.1 Messaggio Catalogo prodotti Tipo Prodotto L informazione sul Tipo prodotto è presente in tutti i formati, ma nel nuovo sistema Arianna + sono stati introdotti codici aggiuntivi rispetto ai formati del sistema preesistente. In caso di conversione, codici vecchi e nuovi vengono convertiti come descritto di seguito Conversione dai formati XML e TXT di Arianna + ai formati EDIFACT e TXT di Arianna 1 ORIGINE Audio AudioCassette CDAudio AudioDisk DVDAudio Book Hardback Paperback SpiralBound Pamphlet LeatherOrFineBinding BoardBook OtherBookFormat SheetMap Globe OtherCartographic Digital CD-ROM CD-I DVD GameCartridge Diskette ElectronicBookText DVD-ROM MiscellaneousPrint Calendar DESTINAZIONE AA AB DB AE DA BA BA BA BA BA BA BA BZ CA CA CZ DA DB DB DD DE DF DA DA PA PC Arianna + - Guida allo sviluppo per le software house pag. 50/66

51 Diary SheetMusic PostcardBookOrPack Poster Video DVDVideo VHSVideo BetamaxVideo MixedMediaProduct QuantityPack TradeOnlyMaterial CounterpackEmpty CounterpackFilled PosterPromotional WindowPiece Spinner GeneralMerchandise Doll SoftToy Toy Game TShirt OtherMerchandise PF PA PJ PK VA VA VK VA BA ZA XA XA ZA XA XA XA ZA ZB ZC ZD ZE ZZ ZZ Conversione dai formati EDIFACT e TXT di Arianna 1 ai formati XML e TXT di Arianna + ORIGINE AB AE BA BZ CA CZ DA DB DD DE DF PA DESTINAZIONE Audicassette AudioDisk Book OtherBookFormat SheetMap OtherCartographic Digital Digital DVD GameCartridge Diskette MiscellaneousPrint Arianna + - Guida allo sviluppo per le software house pag. 51/66

52 PC PF PJ PK VA VK XA ZA ZB ZC ZD ZE ZZ Calendar Diary PostcardBookOrPack Poster Video VHSVideo TradeOnlyMaterial GeneralMerchandise Doll SoftToy Toy Game OtherMerchandise Stato editoriale e Disponibilità Nel sistema Arianna 1 è presente l informazione Stato prodotto che nel nuovo sistema è confluita in due elementi differenti: Stato editoriale e Disponibilità. In caso di conversione, le informazioni vengono mappate come descritto di seguito Conversione dai formati XML e TXT di Arianna + ai formati EDIFACT e TXT di Arianna 1 ORIGINE DESTINAZIONE STATO EDITORIALE DISPONIBILITÀ DETTAGLI SULLA DISPONIBILITÀ STATO PRODOTTO Forthcoming NotAvailable nessun codice NP (Prossima pubblicazione) Active TemporaryUnavailable ManufacturedOnDemand MD (Prodotto su richiesta) Active TemporaryUnavailable Reprinting RE (Ristampa) Active TemporaryUnavailable TemporaryOutOfStock oppure nessun codice TU (Temporaneamente non disponibile) Active Available nessun codice IP (Disponibile) Active NotAvailable OutOfStockIndefinitely UC (Esaurito) Active NotAvailable AvailableDirectFromPublisherOnly RF (Disponibile presso l Editore) Active NotAvailable Con codici diversi da OutOfStockIndefinitely e AvailableDirectFromPublisherOnly oppure nessun codice TU (Temporaneamente non disponibile) OutOfPrint NotAvailable OtherFormatAvailable OF (Fuori catalogodisponibile in altro formato con nuovo codice) OutOfPrint NotAvailable ReplacedByNewEdition OR (Fuori catalogodisponibile in altro formato con nuovo codice) Arianna + - Guida allo sviluppo per le software house pag. 52/66

53 OutOfPrint NotAvailable Con codici diversi da OtherFormatAvailable e ReplacedByNewEdition oppure con nessun codice. OP (Fuori catalogo) OutOfPrint Available nessun codice OP (Fuori catalogo) Conversione dai formati EDIFACT e TXT di Arianna 1 ai formati XML e TXT di Arianna + ORIGINE DESTINAZIONE STATO PRODOTTO STATO EDITORIALE DISPONIBILITÀ DETTAGLI SULLA DISPONIBILITÀ IP (Disponibile) Active Available nessun codice MD (Prodotto su richiesta) Active TemporaryUnavailable ManufacturedOnDemand UC (Esaurito) Active NotAvailable OutOfStockIndefinitely OP (Fuori catalogo) OutOfPrint NotAvailable nessun codice OF (Fuori catalogodisponibile in altro formato con nuovo codice) OR (Fuori catalogodisponibile in altro formato con nuovo codice) RF (Disponibile presso l Editore) OutOfPrint NotAvailable OtherFormatAvailable OutOfPrint NotAvailable ReplacedByNewEdition Active NotAvailable AvailableDirectFromPublisherOnly CS (Disponibilità limitata) Active Available nessun codice NP (Prossima pubblicazione) Forthcoming NotAvailable nessun codice RE (Ristampa) Active TemporaryUnavailable Reprinting TU (Temporaneamente non disponibile) Active TemporaryUnavailable nessun codice Prezzo Nel nuovo sistema Arianna + è possibile indicare un prezzo IVA esclusa, non previsto nel sistema Arianna Conversione dai formati XML e TXT di Arianna + ai formati EDIFACT e TXT di Arianna 1 PREZZO Ammontare del prezzo IVA esclusa ORIGINE CATEGORIA IVA Excluded DESTINAZIONE ALIQUOTA IVA PREZZO CATEGORIA IVA Aliquota IVA in % Ammontare del prezzo IVA inclusa ALIQUOTA IVA S Aliquota IVA in % Arianna + - Guida allo sviluppo per le software house pag. 53/66

54 12 ALLEGATO 2 - FORMATI DISPONIBILI PER LE CLIP In questa tabella sono indicati i formati in cui vengono rese disponibili le anagrafiche prodotti nei file di primo impianto e nei messaggi Catalogo prodotti di aggiornamento. EDIFACT TXT TSV* TXT FLN* TXT STD* XML CLIP XS CLIP S CLIP L CLIP XL Primo impianto Aggiornamento Primo impianto Aggiornamento Primo impianto Aggiornamento * TXT TSV: campi a lunghezza variabile separati da carattere di tabulazione (formato Arianna 1) TXT FLN: campi a lunghezza fissa (formato Arianna 1) TXT STD: campi a lunghezza variabile separati da virgola (formato Arianna 2) Arianna + - Guida allo sviluppo per le software house pag. 54/66

55 13 ALLEGATO 3 - INFORMAZIONI MINIME TRASMESSE NEL MESSAGGIO CATALOGO PRODOTTI Di seguito viene fornito l elenco delle informazioni minime presenti nei record dell archivio prodotti di Arianna e trasmesse alle librerie mediante il messaggio Catalogo prodotti (file di primo impianto e successivi aggiornamenti). Le informazioni minime sono le stesse per tutte le CLIP. Per le regole di trasmissione nel messaggio Catalogo prodotti si rinvia alla documentazione specifica di ciascun formato. INFORMAZIONE NOTE Codice identificativo del record Stato del record Data di creazione del record Data di ultima modifica del record Obbligatoria per i record con stato variato o sostituito. Data di cancellazione del record Obbligatoria per i record con stato cancellato o eliminato dal sistema. Codice identificativo del prodotto Tipologia di prodotto Titolo Produttore Stato editoriale Data di pubblicazione prevista Obbligatoria per i record con stato editoriale annuncio. Data di pubblicazione Obbligatoria per i record con stato editoriale diverso da annuncio. Data di fuori catalogo Obbligatoria per i record con stato editoriale fuori catalogo. Fornitore Disponibilità Ordinabailità Prezzo Obbligatorio per i record con stato editoriale diverso da annuncio. Categoria IVA Obbligatoria per i record con stato editoriale diverso da annuncio. La presenza nell archivio delle informazioni aggiuntive (non obbligatorie) e la loro conseguente trasmissione alle librerie tramite il messaggio Catalogo prodotti dipende dai fornitori: se il fornitore non invia ad Arianna l informazione, questa non sarà trasmessa alle librerie. Arianna + - Guida allo sviluppo per le software house pag. 55/66

56 14 ALLEGATO 4 - CARATTERISTICHE DEL MESSAGGIO CATALOGO PRODOTTI DELLE CLIP L E XL 14.1 I record contenuti Il messaggio Catalogo prodotti delle Clip L e XL contiene: i record inviati dai distributori ad Arianna + normalizzati dalla redazione i record di editori i cui distributori non aderiscono al sistema Arianna + È possibile riconoscerli dal suffisso utilizzato nel codice identificativo del record: i record di distributori Arianna sono identificati dal suffisso -0001; i record di distributori non Arianna sono identificati dal suffisso Modalità di raccolta e aggiornamento dei dati Record di distributori Arianna Le informazioni presenti nei record Arianna vengono fornite quotidianamente dai distributori e sono inserite nella base dati in tempo reale Record di distributori non Arianna Le fonti primarie delle informazioni bibliografiche presenti nei record di distributori non Arianna sono essenzialmente due: le case editrici i folder dei titoli di prossima pubblicazione che pervengono alla redazione I dati dei titoli in commercio vengono inseriti per la maggior parte a partire da schede bibliografiche fornite dalle case editrici e in minima parte libro alla mano. Per i titoli inseriti da scheda, fanno fede le informazioni fornite dall editore, compresa l effettiva uscita e la disponibilità in libreria. Tali informazioni non vengono ulteriormente verificate dalla redazione. Il controllo dei dati e l eventuale aggiornamento dei prezzi di tutti gli editori viene effettuato almeno una volta all anno contattando direttamente le case editrici. Lo stato di disponibilità viene inoltre aggiornato avvalendosi della pubblicazione dei titoli fuori catalogo effettuata mensilmente dai principali editori italiani sul Giornale della Libreria nonché da segnalazioni degli editori stessi Caratteristiche dei dati trasmessi nei record In base al tipo di record a seconda, cioè, che il prodotto sia gestito o meno da distributori del circuito Arianna variano le informazioni trasmesse nel messaggio catalogo prodotti. Nella tabella seguente viene specificato, per ciascuna informazione, se viene trasmessa o meno nei record di distributori Arianna e non Arianna ed eventualmente con quali specificità. Arianna + - Guida allo sviluppo per le software house pag. 56/66

57 INFORMAZIONE Codice identificativo del record RECORD DISTRIBUTORI ARIANNA RECORD DISTRIBUTORI NON ARIANNA NOTE Sì Sì Il codice è composto da <EAN>-<suffisso>. Il suffisso è 0001 per i record di distributori Arianna e 8888 per quelli di distributori non Arianna. Stato del record Sì Sì Nel caso di variazioni, nei record di distributori Arianna vengono trasmessi solo i campi obbligatori e quelli variati, mentre nei record di distributori non Arianna viene sempre ritrasmesso l intero record. Data creazione record Data ultima modifica record Data cancellazione record Tipo di fonte del record Nome della fonte del record Codice identificativo del prodotto Sì Sì Sì Sì Sì Sì Sì Sì Informazione disponibile solo nel formato XML. Sì Sì Informazione disponibile solo nel formato XML. Sì Sì Alla data attuale l unico codice identificativo ammesso è l EAN del prodotto (non vengono gestiti EAN di periodici+add-on né codici privati Alice ). Sì Sì Tipologia di prodotto Numero di pezzi Sì Sì Titolo Sì Sì Autore Sì Sì Collana Sì Sì La stessa collana potrebbe essere descritta in maniera differente nei record di distributori Arianna e non-arianna. NIC Sì Sì Codice produttore No No Alla data attuale questa informazione non viene trasmessa. Partizione EAN produttore Altezza Sì No Larghezza Sì No Spessore Sì No Peso Sì No Stato editoriale Sì Sì Data di prevista pubblicazione Sì Sì La descrizione associata alla partizione EAN viene fornita in un file di testo separato ( file dei produttori ). Sì Sì Nei record di distributori Arianna è nel formato <aaaammgg>. Nei record di distributori non Arianna è nel formato <aaaamm>. Qualora il mese non sia noto, viene inserito il mese fittizio 00. Arianna + - Guida allo sviluppo per le software house pag. 57/66

58 INFORMAZIONE Data di pubblicazione Data di fuori catalogo RECORD DISTRIBUTORI ARIANNA RECORD DISTRIBUTORI NON ARIANNA NOTE Sì Sì Nei record di distributori Arianna è nel formato <aaaammgg>. Nei record di distributori non Arianna è nella forma <aaaa> e indica l anno di pubblicazione. Sì Sì Nei record di distributori Arianna è nel formato <aaaammgg> e indica la data a partire dalla quale contare i 45 giorni per il reso. Nei record di distributori non Arianna è nella forma <aaaamm> e indica la data nella quale il titolo è stato messo fuori catalogo nel database. EAN Fornitore Sì Sì In tutti i record di distributori non Arianna viene utilizzato l EAN Location Code corrispondente a Distributore non Arianna. Territorio di Sì No competenza del fornitore Nuovo fornitore Sì No Questa informazione può essere trasmessa solo nel formato XML. I dati relativi al nuovo fornitore sono: EAN fornitore, Descrizione, Data di inizio distribuzione. Disponibilità Sì Sì Dettagli della Sì No disponibilità Ordinabilità Sì Sì I record di distributori non Arianna sono sempre non ordinabili. Dettagli dell ordinabilità Sì Sì Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. Condizioni per il reso Nei record di distributori non Arianna viene sempre usato il codice NotThroughArianna. Sì Sì Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. Nei record di distributori non Arianna viene sempre usato il codice ApplyToPublisher. Data limite per il reso Sì No Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. Data di disponibilità Sì No Nel caso di record non disponibili o temporaneamente non disponibili. prevista Data di ristampa Sì No prevista Prezzo Sì Sì Categoria IVA Sì Sì Nei record di distributori non Arianna l IVA è sempre assolta. Aliquota IVA Sì No Arianna + - Guida allo sviluppo per le software house pag. 58/66

59 INFORMAZIONE RECORD DISTRIBUTORI ARIANNA RECORD DISTRIBUTORI NON ARIANNA NOTE Nuovo prezzo Sì No Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. I dati relativi al nuovo prezzo sono: Prezzo, Categoria IVA, Aliquota IVA, Data di entrata in vigore del prezzo. Promozione Sì No Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. I dati sulla promozione comprendono: Numero/Descrizione, Data d inizio, Data di fine, Sconto, Termini di pagamento, Quantità minima ordinabile, Quantità di copie che danno diritto alla copia omaggio, Quantità di copie omaggio. Cedola novità Sì No Questa informazione può essere trasmessa solo nei formati XML e TXT Arianna 2. I dati sulla cedola comprendono: Numero, Data d inizio, Data di fine, Sconto, Termini di pagamento, Quantità minima ordinabile, Quantità di copie che danno diritto alla copia omaggio, Quantità di copie omaggio Ingresso e uscita di un prodotto dal circuito Arianna Quando un prodotto librario esce dal circuito Arianna, il record del distributore Arianna viene trasmesso con lo stato eliminato dal sistema e, nello stesso messaggio, quel prodotto viene trasmesso come record di distributore non Arianna con lo stato aggiunta. Analogamente, quando un prodotto librario entra nel circuito Arianna, il record del distributore non Arianna viene trasmesso con lo stato eliminato dal sistema e, nello stesso messaggio, quel prodotto viene trasmesso come record di distributore Arianna con lo stato aggiunta. Di norma, i prodotti non librari (calendari, magliette ecc.) sono presenti solo come record di distributori Arianna: se escono dal circuito Arianna, non vengono più trasmessi. I record eliminati perché inseriti per errore oppure eliminati a seguito di lavori di pulizia dell archivio (per es. titoli annunciati e mai usciti) vengono trasmessi con lo stato cancellato La gestione degli aggiornamenti Nei record di aggiornamento di distributori Arianna vengono trasmessi solo gli elementi variati e quelli obbligatori: lo stato del record è dunque variazioni. Nei record di aggiornamento di distributori non Arianna vengono invece sempre trasmessi tutti i campi: lo stato del record è dunque sostituzione. Arianna + - Guida allo sviluppo per le software house pag. 59/66

60 15 ALLEGATO 5 - CARATTERISTICHE DEI DATI TRASMESSI NEI MESSAGGI CATALOGO PRODOTTI E ONIX- INFORMAZIONI SUL PRODOTTO DELLE CLIP XL 15.1 I record trasmessi Il messaggio ONIX di Informazioni sul prodotto, fornito solo agli abbonati alla CLiP XL, contiene informazioni bibliografiche e catalografiche di dettaglio sia di prodotti di distributori Arianna, sia di prodotti di distributori non Arianna. Tutti i record di distributori non Arianna trasmessi nel file di primo impianto o nei messaggi Catalogo prodotti di aggiornamento hanno un record corrispondente nel file di primo impianto o nei successivi messaggi ONIX di Informazioni sul prodotto. I record di distributori Arianna, invece, possono non avere un record ONIX corrispondente (tipicamente nel caso di materiale non librario quale calendari, magliette ecc.). Il legame tra i dati trasmessi nei messaggi Catalogo prodotti e quelli trasmessi nei messaggi ONIX di Informazioni sul prodotto va costruito sulla base dell EAN del prodotto. Attenzione: ogni giorno il sistema Arianna invia un messaggio Catalogo prodotti e un messaggio ONIX di Informazioni sul prodotto con lo stesso numero di aggiornamento (elemento PriceCatalogueNumber nel Catalogo prodotti ed elemento MessageNumber nel messaggio ONIX), ma i record presenti nei due messaggi non sono gli stessi ossia non riguardano gli stessi prodotti. Il record di aggiornamento viene creato soltanto quando vengono modificate le informazioni trasmesse nello specifico messaggio: per esempio, l aggiunta di una provincia di competenza del fornitore genera un record di aggiornamento nel messaggio Catalogo prodotti, ma non nel messaggio ONIX; analogamente, l aggiunta o la correzione di una categoria CCE genera un record di aggiornamento nel messaggio ONIX, ma non nel messaggio Catalogo prodotti Le informazioni comuni a entrambi i messaggi Nel messaggio ONIX di Informazioni sul prodotto vengono trasmesse informazioni anagrafiche, bibliografiche e catalografiche che ampliano e integrano i dati del messaggio Catalogo prodotti. Nel messaggio ONIX non sono presenti le informazioni logistico-commerciali, trasmesse unicamente nel Catalogo prodotti. Alcune informazioni di base sono però presenti in entrambi i messaggi: Titolo Autore/Curatore Editore Collana e Numero di collana Tipologia di prodotto Vediamo nel dettaglio come vengono trasmesse. Arianna + - Guida allo sviluppo per le software house pag. 60/66

61 Titolo Nel Catalogo prodotti il titolo viene trasmesso in un unico campo Titolo (nel formato XML nell elemento semplice <Title>) con l articolo iniziale scritto fra parentesi tonde alla fine del titolo. Nel caso di un opera composta da più volumi il titolo viene terminato con un punto, seguito dalla stringa "Vol.", dal numero di volume e da almeno una parte del sottotitolo. Nel caso di un volume composto da più tomi, il titolo viene terminato con un punto seguito dalla stringa "Vol.", dal numero del volume, dalla barra "/" e dal numero di tomo. Nel messaggio ONIX viene utilizzato il gruppo di elementi <Title> così composto: <Title> <TitleType>Tipo di titolo</titletype> <TitleText>Titolo completo</titletext> <TitlePrefix>Prefisso del titolo</titleprefix> <TitleWithoutPrefix>Titolo senza prefisso</titlewithoutprefix> </Title> Nel caso di opere in più volumi e/o tomi, viene utilizzato in aggiunta al gruppo <Title> anche il gruppo di elementi <Set> così composto: <Set> <ProductIdentifier> <ProductIDType>Sistema di codifica dell insieme</productidtype> <IDValue>Codice identificativo del prodotto<idvalue> </ProductIdentifier> <TitleOfSet>Titolo dell insieme</titleofset> <ItemNumberWithinSet>Numerazione all interno dell insieme</itemnumberwithinset> <SetItemTitle>Titolo del prodotto all interno dell insieme</setitemtitle> </Set> Esempi Ecco come appaiono i titoli di alcuni libri nel Catalogo prodotti (formato XML): 1. <Title>Libro della giungla (Il)</Title> 2. <Title>Casta. Così i politici italiani sono diventati intoccabili (La)</Title> 3. <Title>Storia d Italia. Vol. 1: I caratteri originali</title> 4. <Title>Teatro italiano (Il). Vol. 2/1: La commedia del Cinquecento</Title> Ed ecco come gli stessi titoli vengono trasmessi nel messaggio ONIX-Informazioni sul prodotto: 1. <Title> <TitleType>01</TitleType> <TitleText>Il libro della giungla</titletext> <TitlePrefix>Il</TitlePrefix> <TitleWithoutPrefix>libro della giungla</titlewithoutprefix> </Title> Arianna + - Guida allo sviluppo per le software house pag. 61/66

62 2. <Title> <TitleType>01</TitleType> <TitleText>La casta. Così i politici italiani sono diventati intoccabili</titletext> <TitlePrefix>La</TitlePrefix> <TitleWithoutPrefix>casta. Così i politici italiani sono diventati intoccabili</titlewithoutprefix> </Title> 3. <Set> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> <ProductIdentifier> <ProductIDType>15</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> <TitleOfSet>Storia d Italia</TitleOfSet> <ItemNumberWithinSet>1</ItemNumberWithinSet> <SetItemTitle>I caratteri originali</setitemtitle> </Set> <Title> <TitleType>01</TitleType> <TitleText>Storia d Italia</TitleText> </Title> 4. <Set> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> <ProductIdentifier> <ProductIDType>15</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> <TitleOfSet>Il teatro italiano</titleofset> <ItemNumberWithinSet>2/1</ItemNumberWithinSet> <SetItemTitle>La commedia del Cinquecento</SetItemTitle> </Set> <Title> <TitleType>01</TitleType> <TitleText>Il teatro italiano</titletext> <TitlePrefix>Il</TitlePrefix> <TitleWithoutPrefix>teatro italiano</titlewithoutprefix> </Title> Autore e curatore Nel Catalogo prodotti autori e curatori vengono trasmessi nel campo Autore (nel formato XML nell elemento semplice <Contributor>) in base a queste regole: Il nome dell autore è espresso nella forma Cognome Nome. Se non è noto il nome per esteso ma solo l iniziale, questa viene posta dopo il cognome, puntata e separata da uno spazio. Arianna + - Guida allo sviluppo per le software house pag. 62/66

63 In presenza di più autori, questi sono separati l uno dall altro con un punto e virgola seguito da uno spazio. Se il nome inserito nel campo appartiene a un curatore, viene indicato con cognome, nome puntato e la sigla "cur." fra parentesi tonde. In presenza di autore e curatore nel medesimo campo, viene scritto prima il nome dell autore e poi quello del curatore. Nel caso di autori vari e non specificati, il campo viene lasciato vuoto. Nel messaggio ONIX viene utilizzato il gruppo di elementi <Contributor> così composto: <Contributor> <ContributorRole>Codice identificativo del tipo di responsabilità</contributorrole> <PersonName>Autore o illustratore o curatore o traduttore nella forma Nome Cognome o N. Cognome </PersonName> <PersonNameInverted>Autore o illustratore o curatore o traduttore nella forma Cognome, Nome o Cognome, N. </PersonNameInverted> </Contributor> Il gruppo viene ripetuto tante volte quante sono le responsabilità descritte. Oltre ad Autori e Curatori, nel messaggio ONIX vengono indicati anche Illustratori e Traduttori Esempi Ecco come appaiono gli autori/curatori di alcuni libri nel Catalogo prodotti (formato XML): 1. <Contributor>Calvino Italo</Contributor> 2. <Contributor>Francesconi G. S.</Contributor> 3. <Contributor>Marx Karl; Engels Friedrich</Contributor> 4. <Contributor>Sanesi R. (cur.)</contributor> 5. <Contributor>Alighieri Dante; Sapegno N. (cur.)</contributor> Ed ecco come gli stessi casi vengono gestiti nel messaggio ONIX-Informazioni sul prodotto: 1. <Contributor> <ContributorRole>A01</ContributorRole> <PersonName>Italo Calvino</PersonName> <PersonNameInverted>Calvino, Italo</PersonNameInverted> </Contributor> 2. <Contributor> <ContributorRole>A01</ContributorRole> <PersonName>G. S. Francesconi</PersonName> <PersonNameInverted>Francesconi, G. S.</PersonNameInverted> </Contributor> Arianna + - Guida allo sviluppo per le software house pag. 63/66

64 3. <Contributor> <ContributorRole>A01</ContributorRole> <PersonName>Karl Marx</PersonName> <PersonNameInverted>Marx, Karl</PersonNameInverted> </Contributor> <Contributor> <ContributorRole>A01</ContributorRole> <PersonName>Friedrich Engels</PersonName> <PersonNameInverted>Engels, Friedrich</PersonNameInverted> </Contributor> 4. <Contributor> <ContributorRole>B01</ContributorRole> <PersonName>R. Sanesi</PersonName> <PersonNameInverted>Sanesi, R.</PersonNameInverted> </Contributor> 5. <Contributor> <ContributorRole>A01</ContributorRole> <PersonName>Dante Alighieri</PersonName> <PersonNameInverted>Alighieri, Dante</PersonNameInverted> </Contributor> <Contributor> <ContributorRole>B01</ContributorRole> <PersonName>N. Sapegno</PersonName> <PersonNameInverted>Sapegno, N.</PersonNameInverted> </Contributor> Editore Nel Catalogo prodotti l editore viene identificato nel campo EAN produttore (nel formato XML nell elemento <ManufacturerEANCode>) mediante il codice corrispondente al prefisso editore incapsulato nel codice EAN del prodotto. La descrizione in chiaro dell editore viene fornita in un file di testo esterno ( file dei Produttori ). Nel messaggio ONIX viene utilizzato il gruppo di elementi <Publisher> così composto: <Publisher> <PublishingRole>Ruolo nei confronti del prodotto</publishingrole> <NameCodeType>Codice identificativo del sistema di codifica dell editore</namecodetype> <NameCodeTypeName>Denominazione del sistema di codifica dell editore</namecodetypename> <NameCodeValue>Codice identificativo dell editore</namecodevalue> <PublisherName>Denominazione dell editore</publishername> </Publisher> Mentre nel Catalogo prodotti l editore è il titolare del prefisso editore contenuto dell EAN, nel messaggio ONIX il codice e la descrizione sono quelli del marchio stampato in copertina. Questo differente approccio può far sì che in alcuni record l editore indicato nel Catalogo prodotti e quello indicato nel messaggio ONIX siano differenti Esempi Nel Catalogo prodotti (formato XML), l editore dei prodotti identificati con l EAN e con l EAN viene indicato così: Arianna + - Guida allo sviluppo per le software house pag. 64/66

65 1. e 2. <Manufacturer> <ManufacturerEANCode> </ManufacturerEANCode> </Manufacturer> Nel file dei Produttori, la descrizione associata al codice è Mondadori. Per gli stessi prodotti, nel messaggio ONIX-Informazioni sul prodotto l editore viene identificato così: 1. <Publisher> <PublishingRole>01</PublishingRole> <NameCodeType>02</NameCodeType> <NameCodeTypeName>I.E. Code</NameCodeTypeName> <NameCodeValue>201655</NameCodeValue> <PublisherName>Mondadori Informatica</PublisherName> </Publisher> 2. <Publisher> <PublishingRole>01</PublishingRole> <NameCodeType>02</NameCodeType> <NameCodeTypeName>I.E. Code</NameCodeTypeName> <NameCodeValue>200183</NameCodeValue> <PublisherName>Mondadori</PublisherName> </Publisher> Collana e Numero di collana Nel Catalogo prodotti la collana viene trasmessa nel campo Collana (nel formato XML nell elemento semplice <TitleOfSeries>) contenente la descrizione per esteso; il numero interno viene trasmesso nel campo Nic (nel formato XML nell elemento semplice <NIC>). Nel messaggio ONIX vengono trasmessi sia la descrizione che il codice della collana. La descrizione della collana può essere differente nei due messaggi. Il numero di collana viene trasmesso in entrambi i messaggi in maniera uniforme Esempi Ecco come appaiono Collana e NIC di alcuni libri nel Catalogo prodotti (formato XML): 1. <Series> <TitleOfSeries>EDIZIONE NAZIONALE</TitleOfSeries> </Series> 2. <Series> <TitleOfSeries>Junior nuovi fantasy</titleofseries> <NIC>43</NIC> </Series> Le stesse informazioni nel messaggio ONIX-Informazioni sul prodotto sono indicate così: Arianna + - Guida allo sviluppo per le software house pag. 65/66

66 1. <Series> <SeriesIdentifier> <SeriesIDType>01</SeriesIDType> <IDTypeName>IE Code</IDTypeName> <IDValue> ENOGD</IDValue> </SeriesIdentifier> <TitleOfSeries>Edizione naz. opere di G. D Annunzio</TitleOfSeries> </Series> 2. <Series> <SeriesIdentifier> <SeriesIDType>01</SeriesIDType> <IDTypeName>IE Code</IDTypeName> <IDValue> JF</IDValue> </SeriesIdentifier> <TitleOfSeries>Junior fantasy</titleofseries> <NumberWithinSeries>43</NumberWithinSeries> </Series> Tipologia di prodotto La tipologia di prodotto viene indicata con un codice sia nel Catalogo prodotti che nel messaggio ONIX- Informazioni sul prodotto, ma i codici utilizzati nei due messaggi sono differenti. Le differenze sono in primo luogo formali: la stessa tipologia di prodotto (per es. libro ) viene indicata nei due messaggi con due codici diversi ( BA o Book ). In alcuni casi, può esserci anche una differenza sostanziale: nel Catalogo prodotti la tipologia di prodotto può essere più dettagliata che nel messaggio ONIX o viceversa. Nel Catalogo prodotti, per es., potrebbe essere specificato CD-I o CD-ROM e nel messaggio ONIX Materiale digitale ; viceversa, nel messaggio ONIX potrebbe essere specificato Libro in brossura o Libro rilegato e nel Catalogo prodotti Libro. Come regola generale, i codici relativi ai prodotti di tipo libro sono più dettagliati nel messaggio ONIX mentre quelli relativi alle altre tipologie di prodotto (audio, materiale digitale ecc.) sono più precisi nel Catalogo prodotti. Si tenga, inoltre, presente che i codici utilizzati nel messaggio Catalogo prodotti variano a seconda del formato (XML, TXT o EDI). Per le corrispondenze tra i codici dei formati Arianna+ e quelli della versione precedente si veda il paragrafo Tipo Prodotto all interno dell Allegato 1 - Elenco delle modifiche al contenuto dei messaggi in fase di conversione Esempi Nel Catalogo prodotti (formato XML), il tipo prodotto di La casta. Così i politici italiani sono diventati intoccabili è Libro ed è indicato così: 1. <ProductForm>Book</ProductForm> Nel messaggio ONIX-Informazioni sul prodotto è invece Libro rilegato ed è indicato così: 1. <ProductForm>BB</ProductForm> Arianna + - Guida allo sviluppo per le software house pag. 66/66