Guida allo sviluppo

Transcript

Guida allo sviluppo

ARIANNA+
GUIDA ALLO SVILUPPO
PER LE SOFTWARE HOUSE
Primo rilascio documento: ottobre 2007
Ultima revisione documento: agosto 2016
ELENCO DELLE MODIFICHE
Revisione dicembre 2007
PARAGRAFO
PAG. DESCRIZIONE
-
-
-
-
-
-
1.1.2 – Ciclo dell’ordine
4
1.1.3 – Dati di vendita
4.4 – I canali di trasmissione e i nomi dei
file
4
9
6.1.1 – Catalogo prodotti
15
6.2.1 – Il messaggio Catalogo prodotti
6.2.2 – Il messaggio Disponibilità a
magazzino
6.2.3 – Il messaggio ONIX di informazioni
sul prodotto
6.3.5 – Informazioni contenute nelle CLiP
18
19
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.
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.”
Eliminata la parola “aggregati” dalla descrizione.
Correzione degli indirizzi di esempio
([email protected] e [email protected]
anziché [email protected] e
[email protected]).
Eliminato “Numero di pezzi” dalle note dell’elemento
“Identificazione e descrizione del prodotto” nella tabella.
Correzione dell’ultima frase del paragrafo.
20
20
Correzione della tabella (Cedola Novità e Condizioni per
il reso non sono disponibili nella CLiP XS).
7.1.4 – Fattura, Nota di debito, Nota di
31
credito
11 – Allegato 2 - Formati disponibili per le 48
CLiP
12 – Allegato 3 - Caratteristiche dei record 49
trasmessi nei messaggi “Catalogo prodotti”
e “Onix-Informazioni sul prodotto” delle
clip L e XL
Correzione della tabella riepilogativa delle informazioni.
Aggiunta dell’allegato.
Revisione aprile 2008
PARAGRAFO
PAG. DESCRIZIONE
-
-
+
In tutto il documento, l’indirizzo “www.arianna.org” è
stato sostituito dall’indirizzo “www.ibuk.it”.
Arianna - Guida allo sviluppo per le software house
pag. 2/62
6.3.5 – Informazioni contenute nelle CLiP
23
12 – Allegato 3 - Informazioni minime
51
trasmesse nel messaggio Catalogo prodotti
13 – Allegato 4 - Caratteristiche del
52
messaggio “Catalogo prodotti” delle CLiP
L e XL
14 – Allegato 5 - Caratteristiche dei dati
56
e “ONIX-Informazioni sul prodotto” delle
CLiP XL
Aggiornamento dei riferimenti agli allegati nel box alla
fine del paragrafo.
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
PAG.
DESCRIZIONE
10.1.1.1 – Conversione dai formati XML e
TXT di Arianna+ ai formati EDIFACT e
TXT di Arianna 1
46
Correzione del codice Boardbook in BoardBook.
Revisione febbraio 2009
PARAGRAFO
PAG. DESCRIZIONE
21
In tutto il documento, sostituzione di “titoli usciti di
catalogo da luglio 2007 in poi” con “titoli usciti di
catalogo nell’ultimo anno”.
Modifica descrizione.
Nella tabella, modifica delle note relative all’elemento
“Identificazione e descrizione del prodotto”.
Nella tabella, modifica della descrizione e delle note
relative all’elemento “Informazioni sul prodotto”.
22
22
24
37
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.
Nella tabella, eliminazione dell’elemento “Termini e
mezzi di pagamento, richiesta di merce in conto
deposito” di dettaglio.
41
Modifica descrizione di tutto il capitolo.
1.1.4 – Servizi web
7
17
6.1.3 – Messaggio ONIX di informazioni
sul prodotto
6.2.2 – Il messaggio Disponibilità a
magazzino
6.2.3 – Il messaggio ONIX di informazioni
sul prodotto
6.3 – Le CLiP di Arianna+
7.1.1 – Ordine
19
7.1.2 – Risposta all’ordine
27
7.2.2 – Fase 2: la risposta all’ordine del
fornitore
9 – I servizi web di Arianna+
+
pag. 3/62
Revisione ottobre 2009
PARAGRAFO
PAG.
1.1.2 – Ciclo dell’ordine
8
9
file
13
19
6.1.2 – Disponibilità a magazzino
20
7.1.1 – Ordine
26
7.1.2 – Risposta all’ordine
29
7.1.3 – Avviso di spedizione
32
7.1.4 – Fattura, Nota di debito, Nota di
credito
34
7.2 – Il flusso informativo tra i soggetti
coinvolti
36
7.2.1.2 – L’ordine diretto al fornitore
38
7.2.1.3 – L’ordine diretto all’agente e la
risposta dell’agente [funzionalità non
ancora disponibile]
8 – I dati di vendita
38
+
41
DESCRIZIONE
Modifica del titolo del documento da “Guida al servizio”
a “Guida allo sviluppo per le software house”.
Modifica della descrizione.
Eliminata la frase “effettuare l’upload o il download di
file”.
Eliminata la frase “mediante i servizi di Arianna+
all’interno del portale iBUK (www.ibuk.it)”.
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.”.
Nella tabella, nella riga relativa a “Identificazione e
descrizione del prodotto”, eliminata la frase
“Identificazione tramite ‘codice Alice’ di prodotti
sprovvisti di EAN”.
Nella tabella, nella riga relativa a “Identificazione del
prodotto”, eliminata la frase “Identificazione tramite
‘codice Alice’ di prodotti sprovvisti di EAN”.
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.
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+.”
Aggiunta della frase “[FUNZIONALITÀ NON ANCORA
DISPONIBILE]” nel titolo del paragrafo.
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
www.ibuk.it (vedi il successivo capitolo 10 – I servizi
web di Arianna+), comparare i propri dati di sell-out
pag. 4/62
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.”
8.1.1 – Relazione vendite
41
13.2.2 – Record di distributori non
Arianna
52
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.”
Modifica della descrizione.
Revisione novembre 2012
PARAGRAFO
PAG. DESCRIZIONE
1.1.3 – Messaggi di reso
4.1 – I formati dei messaggi
8 – La spedizione di merci rese
10.3 – Segnalibro
11.1.1.1 – Conversione dai formati XML e
TXT di Arianna+ ai formati EDIFACT e
TXT di Arianna 1
8
12
41
48
50
Aggiunta del paragrafo.
Correzione delle sigle dei messaggi di reso nella tabella.
Aggiunta del capitolo.
Aggiornamento della descrizione.
Aggiornamento della mappatura dei codici
MixedMediaProduct, QuantityPack e CounterpackFilled.
Revisione agosto 2016
PARAGRAFO
PAG. DESCRIZIONE
10
2 – Il sistema Arianna+
11
4.1 – I formati dei messaggi
13
+
Sostituzione del testo “quelli del mercato” con “ i dati
aggregati dell’insieme delle librerie Arianna+”.
Nel primo punto cancellata la frase “e per compatibilità
con Arianna 1 anche tramite il canale Mail”.
Nel secondo punto cancellata la frase “e per compatibilità
con Arianna 1 anche Edifact e formato testo”.
Eliminazione della frase “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”.
Nella tabella, eliminata la colonna “Formati Arianna 1”.
pag. 5/62
4.2 – La conversione dei messaggi nei vari
formati
13
file
6.1.2 – Disponibilità a magazzino
14
6.2.1 – Il messaggio Catalogo prodotti
23
10.3.1 – Servizi per editori, reti
promozionali e distributori
48
10.3.2 – Servizi per le librerie
49
11 – Allegato 1 - Elenco delle modifiche al
contenuto dei messaggi in fase di
conversione
12 – Allegato 2 - Formati disponibili per le
CLiP
13 – Allegato 3 - Informazioni minime
trasmesse nel messaggio Catalogo
prodotti
14 - Allegato 4 - Caratteristiche del
messaggio “Catalogo prodotti” delle CLiP
L e XL
50
Eliminazione del blocco di testo con la descrizione dei
possibili eventi critici durante la conversione da/a un
formato della precedente versione di Arianna.
Eliminazione di tutti i riferimenti alla posta elettronica
come canale di trasmissione dei messaggi.
Eliminazione di tutti i riferimenti alla tipologia di
disponibilità “Quantità esatta”.
Eliminazione di tutti i riferimenti alla posta elettronica
come canale di trasmissione dei messaggi.
Riscrittura del paragrafo con la descrizione dei record
trasmessi nel messaggio Catalogo prodotti.
Nei paragrafi Statistiche e Classifiche, aggiornamento
del periodo relativo ai dati disponibili.
Aggiunta del paragrafo “Storico confronti”.
Nei paragrafi Statistiche e Classifiche, aggiornamento
del periodo relativo ai dati disponibili e aggiunta della
descrizione della versione senza confronto con i dati A+.
Aggiunta del paragrafo “Storico confronti (con e senza
confronto A+) ”.
Eliminazione dell’Allegato.
54
Eliminazione dell’Allegato.
55
Rinominato “Allegato 1 - Informazioni minime
trasmesse nel messaggio Catalogo prodotti”.
20
526 Rinominato “Allegato 2 - Caratteristiche del messaggio
“Catalogo prodotti” delle CLiP S, L e XL”.
Nella tabella “Caratteristiche dei dati trasmessi nei
record”, nelle Note relative ai campi "Dettagli
dell’ordinabilità", "Condizioni per il reso", "Data limite
per il reso", "Nuovo prezzo", "Promozione" e "Cedola
novità" eliminata la frase "Questa informazione può
essere trasmessa solo nei formati XML e TXT Arianna
2."
15 – Allegato 5 - Caratteristiche dei dati
60 Rinominato “Allegato 3 - Caratteristiche dei dati
trasmessi nei messaggi “Catalogo prodotti” e “ONIXe “ONIX-Informazioni sul prodotto” delle
Informazioni sul prodotto” delle CLiP XL”.
CLiP XL
+
pag. 6/62
INDICE
1
2
3
4
5
6
7
8
9
Cos’è Arianna+ .......................................................................................................................................... 9
1.1 I servizi di Arianna+ ........................................................................................................................... 9
1.1.1 Anagrafiche........................................................................................................................... 9
1.1.2 Ciclo dell’ordine ................................................................................................................... 9
1.1.3 Messaggi di reso ................................................................................................................... 9
1.1.4 Dati di vendita..................................................................................................................... 10
1.1.5 Servizi web ......................................................................................................................... 10
Il sistema Arianna+ .................................................................................................................................. 11
I partecipanti ............................................................................................................................................ 12
3.1 Come si diventa partecipanti di Arianna+......................................................................................... 12
3.2 L’attribuzione dell’EAN Location Code e l’inserimento nel database degli utenti ......................... 12
Formato dei messaggi e modalità di trasmissione ................................................................................... 13
4.1 I formati dei messaggi ...................................................................................................................... 13
4.2 La conversione dei messaggi nei vari formati .................................................................................. 13
4.3 L’imbustamento dei messaggi XML nell’interchange ..................................................................... 14
4.4 I canali di trasmissione e i nomi dei file .......................................................................................... 14
La conferma della ricezione dell’interchange e della correttezza del messaggio .................................... 15
5.1 I messaggi di servizio ....................................................................................................................... 15
5.1.1 Ricevuta di interchange ...................................................................................................... 15
5.1.2 Accettazione di messaggio ................................................................................................. 16
5.1.3 Ricevuta di file TXT ........................................................................................................... 17
5.2 Il flusso dei messaggi di servizio ..................................................................................................... 17
5.2.1 La ricevuta di interchange .................................................................................................. 17
5.2.2 L’accettazione di messaggio ............................................................................................... 18
5.2.3 La ricevuta di file TXT ....................................................................................................... 18
Le anagrafiche prodotti............................................................................................................................ 19
6.1 I messaggi di anagrafica ................................................................................................................... 19
6.1.1 Catalogo prodotti ................................................................................................................ 19
6.1.2 Disponibilità a magazzino .................................................................................................. 20
6.1.3 Messaggio ONIX di informazioni sul prodotto .................................................................. 21
6.2 Il flusso dei messaggi di anagrafica ................................................................................................. 23
6.2.1 Il messaggio Catalogo prodotti ........................................................................................... 23
6.2.2 Il messaggio Disponibilità a magazzino ............................................................................. 23
6.2.3 Il messaggio ONIX di informazioni sul prodotto ............................................................... 24
6.3 Le CLiP di Arianna+......................................................................................................................... 24
Il ciclo dell’ordine ................................................................................................................................... 26
7.1 I messaggi del ciclo dell’ordine ....................................................................................................... 26
7.1.1 Ordine ................................................................................................................................. 26
7.1.2 Risposta all’ordine .............................................................................................................. 29
7.1.3 Avviso di spedizione........................................................................................................... 32
7.1.4 Fattura, Nota di debito, Nota di credito .............................................................................. 34
7.2 Il flusso informativo tra i soggetti coinvolti ..................................................................................... 36
7.2.1 Fase 1: l’invio dell’ordine ................................................................................................... 37
7.2.2 Fase 2: la risposta all’ordine del fornitore .......................................................................... 39
7.2.3 Fase 3: l’avviso di spedizione ............................................................................................. 40
7.2.4 Fase 4: la fattura.................................................................................................................. 40
La spedizione di merci rese ..................................................................................................................... 41
8.1 I messaggi di reso............................................................................................................................. 41
8.1.1 Avviso di spedizione di reso ............................................................................................... 41
8.1.2 Avviso di ricevimento di reso ............................................................................................. 43
I dati di vendita ........................................................................................................................................ 45
9.1 I messaggi di sell-out ....................................................................................................................... 45
+
pag. 7/62
10
11
12
13
9.1.1 Relazione vendite................................................................................................................ 45
I servizi web di Arianna+ ......................................................................................................................... 47
10.1 Ricerche ........................................................................................................................................... 47
10.1.1
Cercalibro ........................................................................................................................ 47
10.1.2
Anagrafiche soggetti e aggiornamento dei dati ............................................................... 47
10.2 Servizi Arianna ................................................................................................................................ 47
10.2.1
Trovalibro ........................................................................................................................ 47
10.2.2
WebOrdering ................................................................................................................... 48
10.3 Segnalibro ........................................................................................................................................ 48
10.3.1
Servizi per editori, reti promozionali e distributori ......................................................... 48
10.3.2
Servizi per le librerie ....................................................................................................... 49
10.4 Notizie .............................................................................................................................................. 50
Allegato 1 - Informazioni minime trasmesse nel messaggio Catalogo prodotti ...................................... 51
Allegato 2 - Caratteristiche del messaggio “Catalogo prodotti” delle CLiP S, L e XL ........................... 52
12.1 I record contenuti ............................................................................................................................. 52
12.2 Modalità di raccolta e aggiornamento dei dati ................................................................................. 52
12.2.1
Record di distributori Arianna ......................................................................................... 52
12.2.2
Record di distributori non Arianna .................................................................................. 52
12.3 Caratteristiche dei dati trasmessi nei record..................................................................................... 52
12.4 Ingresso e uscita di un prodotto dal circuito Arianna....................................................................... 55
12.5 La gestione degli aggiornamenti ...................................................................................................... 55
Allegato 3 - Caratteristiche dei dati trasmessi nei messaggi “Catalogo prodotti” e “ONIX-Informazioni
sul prodotto” delle CLiP XL.................................................................................................................... 56
13.1 I record trasmessi ............................................................................................................................. 56
13.2 Le informazioni comuni a entrambi i messaggi ............................................................................... 56
13.2.1
Titolo ............................................................................................................................... 57
13.2.2
Autore e curatore ............................................................................................................. 58
13.2.3
Editore ............................................................................................................................. 60
13.2.4
Collana e Numero di collana ........................................................................................... 61
13.2.5
Tipologia di prodotto ....................................................................................................... 62
+
pag. 8/62
1 COS’È ARIANNA+
Arianna+, evoluzione di Arianna, è un sistema integrato di servizi di comunicazione e teleordinazione
basato su standard EDI1 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à.
I servizi di Arianna+
1.1
1.1.1
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
1.1.2
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.
1.1.3
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.
+
pag. 9/62

► Per maggiori informazioni sui messaggi di reso si rinvia al capitolo 8 – La spedizione di merci
rese.
1.1.4
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.
1.1.5
Servizi web
Arianna offre ai propri utenti la possibilità di accedere a un’area all’interno del portale www.ibuk.it 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 i dati aggregati dell’insieme delle librerie Arianna+
visualizzare classifiche e statistiche di interesse generale
► Per maggiori informazioni sui Servizi web si rinvia al capitolo 10 – I servizi web di Arianna+.
+
pag. 10/62
2 IL SISTEMA ARIANNA+
Il sistema Arianna+ è costituito dalle seguenti componenti:

un sistema di comunicazione accessibile via Internet tramite il canale FTP;

un sistema di interscambio per l’acquisizione controllata e la distribuzione dei messaggi basato su
SAP XI nativamente XML;

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.
INTERNET
Sistema
di
comunicazione
Sistema
di
interscambio
DB
messaggi
DB
statistiche
Sistema
di
presentazione
+
pag. 11/62
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+ contiene i dati anagrafici e le informazioni relative alla modalità di
accesso al servizio di ciascun partecipante.
Come si diventa partecipanti di Arianna+
3.1
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 www.ibuk.it.
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
www.ibuk.it.
L’attribuzione dell’EAN Location Code e l’inserimento nel
database degli utenti
3.2
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 www.ibuk.it.
+
pag. 12/62
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.
Di seguito viene fornito l’elenco dei messaggi gestiti nel sistema Arianna+ e dei formati supportati per
ciascuno di essi.
Messaggio
Catalogo prodotti
Informazioni sul prodotto
Disponibilità a magazzino
Ordini
Fattura, Nota di debito, Nota di credito
Avviso di spedizione di reso
Avviso di ricevimento di reso
Relazione vendite
Ricevuta di interchange
Accettazione di messaggio
Ricevuta di file TXT
4.2
Sigla
XML TXT
PRICAT
Si
ONIX
Si
STKRPT No
ORDERS Si
ORDRSP Si
DESADV Si
INVOIC
Si
RETADV Si
RECADV Si
SLSRPT
Si
APKICG
Si
APKMSG Si
TXTACK No
Si
No
Si
Si
Si
Si
No
No
No
Si
No
No
Si
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”.
Attenzione: 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.
+
pag. 13/62
L’imbustamento dei messaggi XML nell’interchange
4.3
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 www.ibuk.it.
La descrizione dettagliata della struttura dell’interchange è disponibile nel documento
XML_Schemi_Interchange.pdf contenuto nel file Documenti_generali.zip scaricabile dal sito www.ibuk.it.
4.4
I canali di trasmissione e i nomi dei file
In Arianna+ i messaggi possono essere trasmessi solo tramite trasferimento FTP.
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.
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 www.ibuk.it.
+
pag. 14/62
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
5.1.1
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.
Informazioni obbligatorie (eccetto il
destinatario della notifica).
Destinatario della notifica.
DETTAGLIO (informazioni valide per la singola linea)
Dettagli della trasmissione
dell’interchange
Tipo di trasporto e codifica MIME (se mail).
Informazioni opzionali.
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.
Identificazione e dettagli
dell’interchange
Numero e data dell’interchange.
Mittente e destinatario dell’interchange.
Il numero di interchange di cui si dà
ricevuta è obbligatorio.
Numero di interchange attribuito dal
destinatario.
Azione intrapresa
+
Azione intrapresa dopo la verifica
Informazione obbligatoria.
dell’interchange (accettato in tutto o in parte,
rifiutato).
pag. 15/62
INFORMAZIONE
Descrizione degli errori
riscontrati
DESCRIZIONE
Livello di errore (avvertimento, errore non
bloccante, errore bloccante).
NOTE
Codice e posizione dell’errore.
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.
SOMMARIO (informazioni di riepilogo)
Informazioni di riepilogo
5.1.2
Numero di messaggi.
Accettazione di messaggio
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Informazioni obbligatorie (eccetto il
destinatario della notifica).
Destinatario della notifica.
Dettagli della trasmissione
dell’interchange
Tipo di trasporto e codifica MIME (se mail).
Nome del file originario.
Le informazioni relative al Tipo di
trasporto e alla data/ora della ricezione
sono obbligatorie.
Data e ora effettivamente rilevata della
trasmissione e della ricezione dell’interchange.
Indirizzo IP del mittente e del destinatario.
Tipo di documento EDI.
dell’interchange
Numero e data dell’interchange.
Mittente e destinatario dell’interchange.
Il numero di interchange contenente il
messaggio di cui si dà ricevuta è
obbligatorio.
Numero di interchange attribuito dal
destinatario.
Numero e data della ricevuta di interchange
che precede logicamente l’accettazione del
messaggio corrente.
+
pag. 16/62
INFORMAZIONE
dei messaggi contenuti
nell’interchange
DESCRIZIONE
Numero di messaggio e posizione
nell’interchange.
Tipo di messaggio.
NOTE
Il numero di messaggio e di posizione, il
tipo di messaggio e l’azione intrapresa
sono obbligatori.
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.
5.1.3
Ricevuta di file TXT
Questo messaggio è disponibile solo in formato TXT.
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del file e
azione intrapresa
Nome del file.
Informazioni obbligatorie.
Azione intrapresa (messaggio accettato
totalmente o parzialmente oppure rifiutato).
Errori
Livello e codice di errore, posizione
dell’errore.
Informazioni di riepilogo
5.2
Numero di linee.
Il flusso dei messaggi di servizio
5.2.1
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.
+
pag. 17/62
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 www.ibuk.it. 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
5.2.2
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

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

5.2.3
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 www.ibuk.it.
+
pag. 18/62
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.
6.1
I messaggi di anagrafica
6.1.1
Catalogo prodotti
Questo messaggio è disponibile sia in formato XML che in formato testo.
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Numero, data, mittente, destinatario e funzione
(originale) del documento.
Informazioni sullo stato Numero di riferimento univoco del record.
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.
pag. 19/62
INFORMAZIONE
Identificazione e
descrizione del
prodotto
DESCRIZIONE
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.
Informazioni logisticocommerciali
NOTE
L’identificazione del prodotto è
obbligatoria.
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)..
EAN Location Code del fornitore e province di L’identificazione del fornitore è
competenza.
obbligatoria.
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.
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à.
Numero, periodo di validità e condizioni
particolari (sconti, termini di pagamento,
quantità minima e massima ordinabile, quantità
gratuita) di Promozioni e Cedole novità.
Informazioni di
riepilogo
Numero di linee.
Per informazioni di dettaglio sul messaggio Catalogo prodotti si rinvia alla documentazione disponibile
sul sito www.ibuk.it. 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


Guida al messaggio Catalogo prodotti in formato testo contenuta nella più generale Guida ai
messaggi TXT (Messaggi_TXT.pdf).
6.1.2
Disponibilità a magazzino
Questo messaggio è disponibile solo in formato testo.
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
+
(originale) del documento.
pag. 20/62
INFORMAZIONE
DESCRIZIONE
NOTE
Tipologia di
disponibilità
Tipologia di disponibilità trasmessa e Tabella
dei codici di disponibilità utilizzata.
Questa informazione viene fornita in testata
solo nei messaggi inviati dal
magazzino/fornitore ad Arianna+.
Identificazione del
magazzino
EAN Location Code del magazzino.
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
obbligatoria.
Tipologia di
disponibilità
Tipologia di disponibilità trasmessa ed
eventuale Tabella dei codici di disponibilità
utilizzata.
Questa informazione viene fornita su
ciascuna linea di dettaglio solo nei
messaggi inviati da Arianna+ alle librerie.
Disponibilità
Codice.
Identificazione del
magazzino
EAN Location Code del magazzino.
Questa informazione viene fornita su
ciascuna linea di dettaglio solo nei
messaggi inviati da Arianna+ alle librerie.
Informazioni di
riepilogo
Numero di linee.
Per informazioni di dettaglio sul messaggio Disponibilità a magazzino si faccia riferimento alla Guida ai
messaggi TXT (Messaggi_TXT.pdf) scaricabile dal sito www.ibuk.it.
6.1.3
Messaggio ONIX di informazioni sul prodotto
Questo messaggio è disponibile solo in formato XML. ONIX è un formato standard internazionale
sviluppato da EDItEUR.
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Numero, data, mittente e destinatario del
documento.
Informazioni obbligatorie, eccetto i valori
di default.
Lingua, prezzo e valuta di default del
messaggio.
Informazioni sullo stato Codice identificativo del record.
del record
Stato del record.
Il numero di riferimento e lo stato del
record sono obbligatori.
Tipologia (agenzia bibliografica, distributore
ecc.) e nome dell’organizzazione che ha
emesso il record.
+
pag. 21/62
INFORMAZIONE
Informazioni sul
prodotto
DESCRIZIONE
Codici identificativi del prodotto.
Tipologia di prodotto (Tipologia principale del
prodotto, Dettagli sulla tipologia di prodotto,
Descrizione della tipologia di prodotto,
Categoria commerciale).
NOTE
Le informazioni in corsivo nella colonna
Descrizione sono disponibili unicamente
per i record di editori aderenti al
«Consorzio per l’Editoria Cattolica» (CEC).
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.
Ristampe (Data e Descrizione).
Per informazioni di dettaglio sul messaggio ONIX di Informazioni sul prodotto si rinvia alla
documentazione disponibile sul sito www.ibuk.it. 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.
+
pag. 22/62
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.
6.2.1
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 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 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 quantitativamente diversi 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 dati anagrafici normalizzati da Informazioni Editoriali dei soli titoli di editori ordinabili tramite il
servizio Arianna+;

i dati anagrafici normalizzati da Informazioni Editoriali di tutti i titoli in commercio in Italia.
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+.
6.2.2
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+ 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.
+
pag. 23/62
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+.
6.2.3
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+
6.3
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.
Per l’elenco completo delle informazioni presenti nelle varie CLiP si rinvia alla documentazione
disponibile sul sito www.ibuk.it (sezione Info).
+
pag. 24/62
► Per maggiori informazioni si rinvia all’Allegato 1 - Informazioni minime trasmesse nel messaggio
Catalogo prodotti, all’Allegato 2 - Caratteristiche del messaggio “Catalogo prodotti” delle CLiP S, L e XL e
all’Allegato 3 - Caratteristiche dei dati trasmessi nei messaggi “Catalogo prodotti” e “ONIX-Informazioni
sul prodotto” delle CLiP XL.
+
pag. 25/62
7 IL CICLO DELL’ORDINE
In Arianna+ i partecipanti possono scambiare messaggi relativi a tutte le fasi del ciclo dell’ordine.
I messaggi del ciclo dell’ordine
7.1
7.1.1
Ordine
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Riferimenti ad altri
documenti
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.
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.
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).
Termini di consegna e Richiesta di consegna merce non prima
di evasione dell’ordine, di/alla/entro la data specificata.
gestione delle
Richiesta di fornire il disponibile e cancellare
prenotazioni
il resto.
Nei messaggi di testo non sono presenti. La
richiesta di prenotazione può essere indicata
solo a livello di linea.
Richiesta di fornire il disponibile e mettere in
prenotazione il resto.
Richiesta di annullare l’ordine se non può
essere evaso completamente.
+
pag. 26/62
INFORMAZIONE
Identificazione delle
parti
DESCRIZIONE
NOTE
Acquirente, Fornitore, Agente/rappresentante L’identificazione dell’acquirente è
del fornitore.
obbligatoria.
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).
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.
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, e-mail ecc.).
Termini e mezzi di
Termini di pagamento non standard.
pagamento, richiesta di
Pagamenti a rate.
merce in conto
deposito.
Conto deposito.
Nel formato di testo possono essere indicati
solo Termini di pagamento e Conto deposito in
maniera semplificata..
Specificazione che tutti i titoli ordinati non
sono ancora pubblicati o che sono remainder.
Gestione degli sconti e
delle spese.
Richiesta di sconti o di ripartizione delle
spese espressi come quantità, percentuale,
importo assoluto o importo proporzionale.
Modalità di trasporto.
Modalità di trasporto delle merci
(eventualmente collegate a diversi luoghi di
consegna).
Note di testo libero o informazioni codificate
convenute tra le parti.
Informazioni
aggiuntive
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.
Identificazione della
linea e del prodotto
L’identificazione del prodotto è obbligatoria.
Indicazione di eventuali codici aggiuntivi
(per es. codici interni di acquirente o
fornitore).
Nel formato testo non sono gestiti né i codici
aggiuntivi né i prodotti sostitutivi.
Indicazione di prodotti accettabili come
sostituti.
Indicazione di rifiuto di prodotti sostitutivi.
Quantità
Quantità ordinata e gratuita.
+
L’indicazione della quantità è obbligatoria.
pag. 27/62
INFORMAZIONE
DESCRIZIONE
NOTE
Termini di consegna e Richiesta di consegna merce non prima
di evasione della linea di/alla/entro la data specificata.
Nel formato testo può essere specificata solo la
d’ordine, gestione delle
Richiesta di fornire il disponibile e cancellare richiesta di prenotazione.
prenotazioni
il resto.
Richiesta di fornire il disponibile e mettere in
prenotazione il resto.
Specificazione che il titolo ordinato non è
ancora pubblicato o che è remainder.
documenti
Inserimento di un riferimento alla linea
d’ordine corrente.
Arianna).
Nel formato testo possono essere indicati solo i
riferimenti al numero di promozione e alla
cedola novità.
Numero e data dell’offerta commerciale o di
una linea dell’offerta commerciale.
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.
Il luogo di consegna e
lo split order
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.
delle spese.
Richiesta di sconti o di ripartizione delle
spese espressi come quantità, percentuale,
importo assoluto o importo proporzionale.
Indicazione del prezzo
Prezzo di catalogo o prezzo promozionale.
Nel formato testo possono essere indicati gli
sconti in maniera semplificata.
Informazioni
aggiuntive
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
www.ibuk.it. Si vedano in particolare:
+
pag. 28/62

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


Guida al messaggio Ordini in formato testo contenuta nella più generale Guida ai messaggi TXT
(Messaggi_TXT.pdf).
7.1.2
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
(originale, variazione o copia) del documento.
Stato dell’ordine
Codice di risposta all’ordine (accettato con
variazioni, accettato senza variazioni, non ancora
processato, autorizzato dall’agente, elaborato da
Arianna+, rifiutato).
L’indicazione del codice di risposta
all’ordine è obbligatorio.
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.).
documenti
Numero e data dell’ordine cui si risponde
(attribuito dall’acquirente, dall’agente o dal
fornitore).
Arianna).
nell’ordine).
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.
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.
Termini di consegna
dell’ordine
+
Consegna merce promessa non prima di/alla/entro
la data specificata o differita alla data specificata.
pag. 29/62
INFORMAZIONE
parti
DESCRIZIONE
NOTE
Acquirente, Fornitore, Agente/rappresentante del
fornitore.
L’identificazione dell’acquirente è
obbligatoria.
Chi ha effettuato l’ordine (se diverso
dall’acquirente), Ufficio centrale dell’acquirente,
Agente/rappresentante dell’acquirente.
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.
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, e-mail ecc.).
Termini e mezzi di
pagamento, invio di
merce in conto
deposito.
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.
delle spese.
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
dal fornitore.
Modalità di trasporto
Modalità di trasporto delle merci.
Possono essere usati in caso di ordine accettato con Nei messaggi di testo non sono presenti.
dal fornitore.
Informazioni
aggiuntive
Indicazione di eventuali codici aggiuntivi (per es.
codici interni di acquirente o fornitore).
Indicazione del prodotto ordinato di cui viene
fornito un sostituto.
+
obbligatoria.
Nel formato testo non sono gestiti né i
codici aggiuntivi né i prodotti sostitutivi.
pag. 30/62
INFORMAZIONE
Quantità
Stato della linea
d’ordine
DESCRIZIONE
NOTE
Quantità ordinata, già spedita, fatturata, in
backorder, allocata per l’acquirente, cancellata,
gratuita, in sostituzione, minima e massima
ordinabile.
La quantità ordinata è obbligatoria.
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).
Il codice di risposta alla linea d’ordine è
obbligatorio.
Nei messaggi di testo non sono gestite la
quantità fatturata, in sostituzione, minima e
massima.
Causale della modifica o del rifiuto della linea
d’ordine (per es. prodotto fuori catalogo, esaurito,
ordinabile solo presso l’editore ecc.).
documenti
Inserimento di un riferimento alla linea di risposta
all’ordine corrente.
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.
nell’ordine).
Termini di consegna e
di evasione della linea
d’ordine
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.
Il luogo di consegna e
lo split order
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.
delle spese
Indicazione di sconti o di ripartizione delle spese
espressi come quantità, percentuale, importo
assoluto o importo proporzionale.
+
pag. 31/62
INFORMAZIONE
Indicazione del prezzo
Informazioni
aggiuntive
DESCRIZIONE
NOTE
Prezzo applicato dal fornitore.
Prezzo di catalogo e prezzo promozionale.
Nel messaggio di testo è possibile indicare
solo il prezzo applicato dal fornitore.
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

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


Guida al messaggio Risposta all’ordine in formato testo contenuta nella più generale Guida ai
7.1.3
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
(originale o copia) del documento.
documenti
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.
Date correlate alla
spedizione
+
Data di spedizione.
La data di spedizione è obbligatoria.
Consegna alla/entro/non prima della data
specificata.
Nei messaggi di testo non sono gestite le
date di consegna.
pag. 32/62
INFORMAZIONE
parti
DESCRIZIONE
NOTE
Acquirente, Fornitore, Agente/rappresentante del
fornitore.
L’identificazione di fornitore e acquirente
è obbligatoria.
Chi ha effettuato l’ordine (se diverso
dall’acquirente), Ufficio centrale dell’acquirente.
Nei messaggi di testo, oltre a fornitore e
acquirente, è possibile indicare solo il
destinatario della merce.
Destinatario della merce e della fattura (se diversi
dall’ordinante).
Parti a cui inviare la notifica (inserito da Arianna+
in base al profilo utente nel database dei
partecipanti).
indirizzo, riferimenti (per es. a codici identificativi
interni, codice fiscale, partita IVA), persone da
contattare, modalità di comunicazione (telefono,
fax, e-mail ecc.).
Mezzo e spese di
trasporto
Modalità di spedizione (posta ordinaria, corriere
ecc.).
Porto franco/Porto assegnato.
Caratteristiche fisiche e Numero e tipo di contenitori/pacchi.
identificazione
dell’imballo
Nei messaggi di testo è possibile indicare
solo il numero di colli.
Descrizione testuale (descrizione primaria del
prodotto, edizione, collana, tipo prodotto, numero
volume, descrizione non strutturata) del prodotto
in consegna.
obbligatoria.
Nel formato testo non sono gestiti né i
codici aggiuntivi né il prodotto
originariamente ordinato.
Identificazione del prodotto originariamente
ordinato e sostituito con quello in spedizione.
Dimensioni fisiche,
prezzo e quantità in
spedizione
Peso, altezza, spessore, larghezza
La quantità in spedizione è obbligatoria.
Prezzo applicato dal fornitore.
Nel formato testo non sono gestite altre
informazioni oltre alla quantità in
spedizione.
Prezzo di catalogo e prezzo promozionale.
Quantità in spedizione.
Quantità cancellata, spedita d’ufficio, gratuita,
ordinata, precedentemente spedita, resa, in
backorder.
+
pag. 33/62
INFORMAZIONE
documenti
DESCRIZIONE
Inserimento di un riferimento alla linea di avviso
di spedizione corrente.
NOTE
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.
Informazioni
aggiuntive
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

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


Guida al messaggio Avviso di spedizione in formato testo contenuta nella più generale Guida ai
7.1.4
Fattura, Nota di debito, Nota di credito
Questi messaggi sono disponibili solo in formato XML.
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del messaggio
(trasmissione aggiuntiva o copia) del documento.
Tipo di documento (fattura, nota di debito, nota di
credito).
+
pag. 34/62
INFORMAZIONE
DESCRIZIONE
Riferimenti ad altri documenti Numero e data del messaggio contenente il
Arianna).
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.
NOTE
Informazioni opzionali. Solo
nella Nota di debito e nella Nota
di credito è obbligatorio il
riferimento alla Fattura.
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.
Identificazione delle parti
Acquirente, Fornitore, Destinatario della
fattura/nota di debito/nota di credito.
Società di servizi, Sottounità interna.
L’identificazione di acquirente,
fornitore e destinatario del
documento è obbligatoria.
Parte a cui inviare la notifica.
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, e-mail ecc.).
Indicazione della valuta,
termini di pagamento
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 e spese
Indicazione di sconti o spese espressi come
percentuale o importo assoluto.
Note fiscali e altre
informazioni aggiuntive
Note fiscali libere.
Note fiscali codificate (contributo CONAI
assolto, esente da bollo).
Identificazione della linea e
del prodotto
Descrizione testuale (descrizione primaria del
prodotto, edizione, collana, tipo prodotto, numero
volume, descrizione non strutturata) del prodotto
fatturato.
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).
L’indicazione del prezzo e delle
imposte è obbligatorio.
Tipo, categoria e aliquota di imposta applicata,
esenzioni, esclusioni e qualsiasi altro caso di
regime fiscale.
+
pag. 35/62
INFORMAZIONE
DESCRIZIONE
NOTE
Indicazione di sconti e spese
Indicazione di sconti o spese espressi come
percentuale o importo assoluto.
Note fiscali, sequenza di
calcolo dello sconto e altre
informazioni aggiuntive
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.
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.
Importi totali di linea
Totale lordo, totale lordo defiscalizzato, totale
L’indicazione del totale di linea
riaccredito IVA, totale netto, totale sconti e spese. è obbligatorio.
Totali riassuntivi di fattura
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.
Totale netto fattura, Totale IVA
e Totale da pagare a saldo sono
obbligatori.
Subtotali IVA
Imponibile e imposta per le differenti aliquote
IVA (subtotali in piede fattura).
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 www.ibuk.it. 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

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à:
+
pag. 36/62

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
7.2.1
7.2.1.1 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
+
pag. 37/62
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.
7.2.1.2 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.
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 2.
7.2.1.3 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.
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
+
pag. 38/62
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
7.2.2
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:
+
pag. 39/62

è 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
7.2.3
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.
7.2.4
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.
+
pag. 40/62
8 LA SPEDIZIONE DI MERCI RESE
In Arianna+ i partecipanti possono scambiare informazioni relative alla spedizione e al ricevimento di merci
rese.
8.1
I messaggi di reso
8.1.1
Avviso di spedizione di reso
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Numero, data, mittente, destinatario e funzione (originale o
copia) del documento.
documenti
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.
Date correlate alla
spedizione
Data di spedizione.
parti
Acquirente, Fornitore, Agente/rappresentante del fornitore.
L’identificazione di fornitore e
acquirente è obbligatoria.
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).
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
+
pag. 41/62
INFORMAZIONE
DESCRIZIONE
NOTE
Mezzo e spese di
trasporto
Modalità di spedizione (posta ordinaria, corriere ecc.).
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.
Caratteristiche
fisiche e
identificazione
dell’imballo
Numero e tipo di contenitori/pacchi.
Dimensioni.
Descrizione testuale (descrizione primaria del prodotto,
edizione, collana, tipo prodotto, numero volume, descrizione
non strutturata) del prodotto in consegna.
obbligatoria.
Indicazione di eventuali codici aggiuntivi (per es. codici
interni di acquirente o fornitore).
Identificazione del prodotto originariamente ordinato e
sostituito con quello in spedizione.
Dimensioni fisiche,
prezzo e quantità in
spedizione
Peso, altezza, spessore, larghezza
Quantità in spedizione.
La quantità in spedizione è
obbligatoria.
Quantità resa.
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.
documenti
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.
Totali di linea
Importo totale di linea.
Totale lordo di linea, totale lordo di linea al netto dell’IVA,
totale dell’IVA di linea.
Riferimenti alla
confezione e
informazioni
aggiuntive
Riferimenti alla confezione contenente il prodotto descritto
nella linea corrente.
L’importo totale di linea è
obbligatorio.
Note di testo libero o informazioni codificate convenute tra
le parti.
+
pag. 42/62
INFORMAZIONE
Informazioni di
riepilogo
DESCRIZIONE
Importo totale del messaggio.
NOTE
Il numero di linee è obbligatorio.
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.
Per informazioni di dettaglio sul messaggio Avviso di spedizione di reso si rinvia alla documentazione

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.
8.1.2
Avviso di ricevimento di reso
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
Numero, data, mittente, destinatario e funzione (originale o copia) Informazioni obbligatorie.
del documento.
Stato della spedizione contenente le merci rese.
documenti
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.
parti
Acquirente, Fornitore, Agente/rappresentante del fornitore.
Chi ha effettuato l’ordine (se diverso dall’acquirente), Ufficio
centrale dell’acquirente.
L’identificazione di
fornitore e acquirente è
obbligatoria.
Destinatario della merce (se diverso dal fornitore).
Destinatario della nota di credito (se diverso dall'acquirente).
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, e-mail ecc.).
+
pag. 43/62
INFORMAZIONE
Mezzo e spese di
trasporto
DESCRIZIONE
Modalità di spedizione (posta ordinaria, corriere ecc.).
NOTE
Caratteristiche fisiche e Numero e tipo di contenitori/pacchi.
identificazione
Dimensioni.
dell’imballo
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

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
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.
+
pag. 44/62
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
9.1.1
Relazione vendite
INFORMAZIONE
DESCRIZIONE
NOTE
Identificazione del
messaggio
(originale, cancellazione, sostituzione o copia) del
documento.
Identificazione del
periodo di rilevazione
Giorno iniziale e finale di rilevazione dei dati di
vendita.
documenti
Arianna).
Rivenditore.
L’identificazione del rivenditore è
obbligatoria.
Nei messaggi di testo può essere inserito
solo il numero di una precedente relazione
Numero e data di una precedente relazione vendite.
vendite.
parti
Parte a cui inviare la notifica.
indirizzo, persone da contattare, modalità di
Nei messaggi di testo può essere inserito
solo l’EAN Location Code del rivenditore.
giornata di vendita
Giornata in cui sono state effettuate le vendite.
provincia di vendita
Sigla della provincia di vendita (nel solo caso di
librerie online).
Informazione opzionale.
+
pag. 45/62
INFORMAZIONE
Quantità, prezzo di
listino e valore
incassato
DESCRIZIONE
NOTE
Quantità venduta o resa dal cliente.
L’indicazione della quantità è obbligatoria.
Prezzo di listino del prodotto venduto.
Nei messaggi di testo non possono essere
indicati prezzo e totale incassato.
Totale incassato.
Per informazioni di dettaglio sul messaggio Relazione vendite si rinvia alla documentazione disponibile

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


Guida al messaggio Relazione vendite in formato testo contenuta nella più generale Guida ai
9.2
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.
+
pag. 46/62
10 I SERVIZI WEB DI ARIANNA+
I partecipanti di Arianna+ possono usufruire di numerosi servizi all’interno del portale iBUK (www.ibuk.it)
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.
10.1
Ricerche
10.1.1
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 www.ibuk.it (sezione Info).
10.1.2
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.
10.2
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.
10.2.1
Trovalibro
Con il servizio Trovalibro le librerie possono verificare la disponibilità di un titolo presso i magazzini dei
fornitori.
+
pag. 47/62
10.2.2
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.
10.3
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.
10.3.1
Servizi per editori, reti promozionali e distributori
10.3.1.1 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 dal 2009 aggregati su base mensile.
Sellout giornaliero: dati di vendita dell'anno corrente e dell'anno precedente aggregati su base
giornaliera.
Confronto: confronto tra i dati di vendita omogenei dell'anno corrente e dell’anno precedente, e tra i
dati di vendita omogenei degli ultimi due anni conclusi, aggregati su base mensile. Sono disponibili
solo i dati dei mesi già conclusi.
10.3.1.2 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 dell'anno corrente e dell'anno precedente.
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.
+
pag. 48/62
10.3.1.3 Storico confronti
Gli utenti possono utilizzare lo Storico confronti di Segnalibro per analizzare le proprie vendite, confrontate
anno su anno, nelle librerie aderenti al circuito Arianna+ in entrambi gli anni considerati.
Per gli editori sono disponibili i dati dal 2009 all'ultimo anno concluso, per le Reti promozionali e i
distributori dal 2011 all'ultimo anno concluso.
10.3.2
Servizi per le librerie
10.3.2.1 Statistiche (con e senza confronto A+)
Le librerie possono utilizzare le Statistiche (confronto A+) 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 dal 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 tabelle:



Sellout mensile: dati di vendita da gennaio 2009 in poi aggregati su base mensile.
Sellout giornaliero: dati di vendita dell'anno corrente e dell'anno precedente aggregati su base
giornaliera.
Confronto: confronto tra i dati di vendita dell'anno corrente e dell’anno precedente e tra i dati di
vendita degli ultimi due anni conclusi, aggregati su base mensile. Sono disponibili solo i dati dei
mesi già conclusi.
Le Statistiche sono disponibili anche nella versione senza confronto con il dato aggregato delle librerie A+,
che permette a Catene e Gruppi librari di analizzare separatamente i dati delle proprie librerie (funzionalità
non disponibile nelle analisi che includono il confronto con le librerie A+).
10.3.2.2 Classifiche (con e senza confronto A+)
Le librerie possono utilizzare le Classifiche (confronto A+) 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.
Le Classifiche sono disponibili anche nella versione senza confronto con il dato aggregato delle librerie A+,
che permette a Catene e Gruppi librari di analizzare separatamente i dati delle proprie librerie (funzionalità
non disponibile nelle analisi che includono il confronto con le librerie A+).
10.3.2.3 Storico confronti (con e senza confronto A+)
Le librerie possono utilizzare lo Storico confronti (conf. A+) di Segnalibro per analizzare le proprie vendite
confrontate anno su anno e paragonarle con i dati aggregati di tutte le librerie aderenti al circuito Arianna+.
Sono disponibili i dati dal 2011 all'ultimo anno concluso.
+
pag. 49/62
Lo Storico confronti è disponibile anche nella versione senza confronto con il dato aggregato delle librerie
A+, che permette a Catene e Gruppi librari di analizzare separatamente i dati delle proprie librerie
(funzionalità non disponibile nelle analisi che includono il confronto con le librerie A+).
10.4
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.
+
pag. 50/62
11 ALLEGATO 1 - 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
Codice identificativo del record
Stato del record
Data di creazione del record
Data di ultima modifica del record
Data di cancellazione del record
Codice identificativo del prodotto
Tipologia di prodotto
Titolo
Produttore
Stato editoriale
Data di pubblicazione prevista
Data di pubblicazione
Data di fuori catalogo
Fornitore
Disponibilità
Ordinabailità
Prezzo
Categoria IVA
NOTE
Obbligatoria per i record con stato variato o sostituito.
Obbligatoria per i record con stato cancellato o eliminato dal sistema.
Obbligatoria per i record con stato editoriale annuncio.
Obbligatoria per i record con stato editoriale diverso da annuncio.
Obbligatoria per i record con stato editoriale fuori catalogo.
Obbligatorio per i record con stato editoriale diverso da annuncio.
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.
+
pag. 51/62
12 ALLEGATO 2 - CARATTERISTICHE DEL MESSAGGIO
“CATALOGO PRODOTTI” DELLE CLIP S, L E XL
12.1
I record contenuti
Il messaggio Catalogo prodotti delle Clip S, 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 -8888.
12.2
Modalità di raccolta e aggiornamento dei dati
12.2.1
Record di distributori Arianna
Le informazioni presenti nei record Arianna vengono fornite quotidianamente dai distributori e sono
inserite nella base dati in tempo reale.
12.2.2
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.
12.3
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à.
+
pag. 52/62
INFORMAZIONE
RECORD
DISTRIBUTORI
ARIANNA
RECORD
DISTRIBUTORI
NON ARIANNA
NOTE
Codice
identificativo del
record
Sì
Sì
Stato del record
Sì
Sì
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”).
Tipologia di
prodotto
Numero di pezzi
Titolo
Autore
Collana
Sì
Sì
Sì
Sì
Sì
Sì
Sì
Sì
Sì
Sì
NIC
Codice produttore
Sì
No
Sì
No
Partizione EAN
produttore
Sì
Sì
Altezza
Larghezza
Spessore
Peso
Stato editoriale
Data di prevista
pubblicazione
Sì
Sì
Sì
Sì
Sì
Sì
No
No
No
No
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.
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.
La stessa collana potrebbe essere descritta in
maniera differente nei record di distributori
Arianna e non-Arianna.
Alla data attuale questa informazione non viene
trasmessa.
La descrizione associata alla partizione EAN
viene fornita in un file di testo separato (“file dei
produttori”).
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.
+
pag. 53/62
INFORMAZIONE
Data di
pubblicazione
Data di fuori
catalogo
RECORD
DISTRIBUTORI
ARIANNA
RECORD
DISTRIBUTORI
NON ARIANNA
Sì
Sì
Sì
Sì
EAN Fornitore
Sì
Sì
Territorio di
competenza del
fornitore
Nuovo fornitore
Sì
No
Sì
No
NOTE
<aaaammgg>.
Nei record di distributori non Arianna è nella
forma <aaaa> e indica l’anno di pubblicazione.
<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.
In tutti i record di distributori non Arianna viene
utilizzato l’EAN Location Code 8023014001391
corrispondente a “Distributore non Arianna”.
Questa informazione può essere trasmessa solo
nel formato XML.
I dati relativi al nuovo fornitore sono: EAN
fornitore, Descrizione, Data di inizio
distribuzione.
Disponibilità
Dettagli della
disponibilità
Ordinabilità
Sì
Sì
Sì
No
Sì
Sì
Dettagli
dell’ordinabilità
Condizioni per il
reso
Data limite per il
reso
Data di
disponibilità
prevista
Data di ristampa
prevista
Prezzo
Categoria IVA
Sì
Sì
Sì
Sì
Sì
No
Sì
No
Sì
No
Sì
Sì
Sì
Sì
Aliquota IVA
Nuovo prezzo
Sì
Sì
No
No
Promozione
Sì
No
+
I record di distributori non Arianna sono sempre
non ordinabili.
Nei record di distributori non Arianna viene
sempre usato il codice NotThroughArianna.
Nei record di distributori non Arianna viene
sempre usato il codice ApplyToPublisher.
Nel caso di record non disponibili o
temporaneamente non disponibili.
Nei record di distributori non Arianna l’IVA è
sempre assolta.
I dati relativi al nuovo prezzo sono: Prezzo,
Categoria IVA, Aliquota IVA, Data di entrata in
vigore del prezzo.
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.
pag. 54/62
INFORMAZIONE
Cedola novità
12.4
RECORD
DISTRIBUTORI
ARIANNA
RECORD
DISTRIBUTORI
NON ARIANNA
Sì
No
NOTE
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.
12.5
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.
+
pag. 55/62
13 ALLEGATO 3 - CARATTERISTICHE DEI DATI TRASMESSI
NEI MESSAGGI “CATALOGO PRODOTTI” E “ONIXINFORMAZIONI SUL PRODOTTO” DELLE CLIP XL
13.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.
13.2
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
Vediamo nel dettaglio come vengono trasmesse.
+
pag. 56/62
13.2.1
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>
13.2.1.1 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>
+
pag. 57/62
2.
<Title>
<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>9788806342319</IDValue>
<ProductIdentifier>
<TitleOfSet>Storia d’Italia</TitleOfSet>
<ItemNumberWithinSet>1</ItemNumberWithinSet>
<SetItemTitle>I caratteri originali</SetItemTitle>
</Set>
<Title>
<TitleText>Storia d’Italia</TitleText>
</Title>
4.
<Set>
<ProductIdentifier>
<ProductIdentifier>
<TitleOfSet>Il teatro italiano</TitleOfSet>
<ItemNumberWithinSet>2/1</ItemNumberWithinSet>
<SetItemTitle>La commedia del Cinquecento</SetItemTitle>
</Set>
<Title>
<TitleText>Il teatro italiano</TitleText>
<TitlePrefix>Il</TitlePrefix>
<TitleWithoutPrefix>teatro italiano</TitleWithoutPrefix>
</Title>
13.2.2
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.
+
pag. 58/62




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.
13.2.2.1 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>
<PersonName>G. S. Francesconi</PersonName>
<PersonNameInverted>Francesconi, G. S.</PersonNameInverted>
</Contributor>
+
pag. 59/62
3.
<Contributor>
<PersonName>Karl Marx</PersonName>
<PersonNameInverted>Marx, Karl</PersonNameInverted>
</Contributor>
<Contributor>
<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>
<PersonName>Dante Alighieri</PersonName>
<PersonNameInverted>Alighieri, Dante</PersonNameInverted>
</Contributor>
<Contributor>
<ContributorRole>B01</ContributorRole>
<PersonName>N. Sapegno</PersonName>
<PersonNameInverted>Sapegno, N.</PersonNameInverted>
</Contributor>
13.2.3
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.
13.2.3.1 Esempi
Nel Catalogo prodotti (formato XML), l’editore dei prodotti identificati con l’EAN 978-88-04-52503-5 e
con l’EAN 978-88-04-57589-4 viene indicato così:
+
pag. 60/62
1. e 2.
<Manufacturer>
<ManufacturerEANCode>9788804</ManufacturerEANCode>
</Manufacturer>
Nel file dei Produttori, la descrizione associata al codice 9788804 è “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>
13.2.4
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.
13.2.4.1 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ì:
+
pag. 61/62
1.
<Series>
<SeriesIdentifier>
<SeriesIDType>01</SeriesIDType>
<IDTypeName>IE Code</IDTypeName>
<IDValue>200183-ENOGD</IDValue>
</SeriesIdentifier>
<TitleOfSeries>Edizione naz. opere di G. D’Annunzio</TitleOfSeries>
</Series>
2.
<Series>
<SeriesIdentifier>
<SeriesIDType>01</SeriesIDType>
<IDTypeName>IE Code</IDTypeName>
<IDValue>200183-JF</IDValue>
</SeriesIdentifier>
<TitleOfSeries>Junior fantasy</TitleOfSeries>
<NumberWithinSeries>43</NumberWithinSeries>
</Series>
13.2.5
La tipologia di prodotto viene indicata con un codice sia nel Catalogo prodotti che nel messaggio ONIXInformazioni 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.
13.2.5.1 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>
+
pag. 62/62

Guida allo sviluppo

Transcript

Documenti analoghi

_Curriculum artistico di Arianna Lerussi+_

Scarica comunicato stampa

LA SEMINA CON IL SISTEMA NATURALE DI MASANOBU FUKUOKA

CV - ABC ARTE

Le Ville Romane ai piedi del Golfo. Stabia e Oplontis

Recoaro, 23 aprile 2014 Circ. n° 390 AGLI ALLIEVI AI DOCENTI

Numero 14

Scarica il programma

ARIANN AN TINORI Biography

Alessia Marcuzzi - Arianna Bergamaschi