Tracciato record per l`importazione dei dati delle Cantine

ABACO S.p.A.
TRACCIATO RECORD PER IMPORTAZIONE DATI CANTINE SOCIALI
Versione 2.1
Del 20/11/2014
Redatto
Daniele Zaffanella
ABACO
Verificato
Tommaso Nolli
ABACO
Approvato
Tommaso Nolli
ABACO
Lista di distribuzione
Corrado Corradi
Marcello Finessi
Matteo Campagnari
ABACO
REG. EMILIA ROMAGNA
REG. EMILIA ROMAGNA
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 1 di 11
INDICE
1. INTRODUZIONE ........................................................................................................................................... 3
1.1. PREMESSA ........................................................................................................................................................... 3
1.2. SCOPO ................................................................................................................................................................ 3
1.3. CAMPO DI APPLICAZIONE ........................................................................................................................................ 3
1.4. RIFERIMENTI ........................................................................................................................................................ 3
1.5. REGISTRO DELLE MODIFICHE ................................................................................................................................... 3
1.6. ACRONIMI E GLOSSARIO......................................................................................................................................... 3
2. CONTESTO DELL’INTERVENTO DEL PROGETTO ............................................................................................ 4
2.1. CONTESTO E RIFLESSI SULL’ASPETTO ORGANIZZATIVO .................................................................................................. 4
2.2. UTENTI INTERESSATI .............................................................................................................................................. 4
3. TRACCIATO RECORD ................................................................................................................................... 5
3.1. RECORD “00” (RECORD DI TESTA) ............................................................................................................................ 6
3.2. RECORD “60” (SOCIO) .......................................................................................................................................... 6
3.3. RECORD “64” (IG/DO RIVENDICATE) ...................................................................................................................... 7
3.4. RECORD “66” (UNITÀ VITATE UTILIZZATE NELLE RIVENDICAZIONI) ................................................................................... 8
3.5. RECORD “51” (CESSIONI DI UVA TRAMITE F1, IN USCITA) ............................................................................................. 9
3.6. RECORD “99” (RECORD DI CODA) ............................................................................................................................ 9
4. STRUTTURA DEL FILE ..................................................................................................................................10
5. CARICAMENTO TOTALE E PARZIALE ............................................................................................................10
5.1. TOTALE .............................................................................................................................................................. 10
5.2. PARZIALE ............................................................................................................................................................ 10
6. ESITO DEL CARICAMENTO............................................................................................................................11
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 2 di 11
1. INTRODUZIONE
1.1. PREMESSA
Definizione del tracciato record accettato dal portale Siti Farmer Vino per l’importazione dei dati delle
Cantine Sociali.
1.2. SCOPO
Il proposito di questo documento è descrivere il tracciato record accettato dal portale Siti Farmer Vino per
l’importazione dei dati delle Cantine Sociali.
1.3. CAMPO DI APPLICAZIONE
Portale siti farmer vino per la dichiarazione di raccolta uva e produzione vino relative alla campagna 2012.
1.4. RIFERIMENTI
Codice
Documento
Bozza tracciato Cantine Sociali.pdf
SPECIFICA TECNICA DI FORNITURA DICHIARAZIONI DI RACCOLTA
UVA E PRODUZIONE VINO - Versione 4.0
1.5. REGISTRO DELLE MODIFICHE
N° Revisione
Descrizione
Autore
Data Emissione
1
Prima Emissione
D.ZAFFANELLA
19/09/2012
2
Aggiornamento
D.ZAFFANELLA
20/11/2014
1.6. ACRONIMI E GLOSSARIO
Abbreviazione utilizzata
Versione 2.1
Del 20/11/2014
Nome completo
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 3 di 11
2. CONTESTO DELL’INTERVENTO DEL PROGETTO
2.1. Contesto
e Riflessi sull’Aspetto Organizzativo
Nel presente documento viene descritto il tracciato record accettato dal portale Siti Farmer Vino per
l’importazione dei dati delle Cantine Sociali.
2.2. Utenti
interessati
AGREA, Cantine Sociali
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 4 di 11
3. TRACCIATO RECORD
I dati dovranno essere presentati in un unico file secondo il formato descritto di seguito.
Il formato è stato generato partendo da quello utilizzato per le campagne precedenti e descritto nel
documento “Bozza tracciato Cantine Sociali.pdf” (Versione 4.0) del 28 dicembre 2011.
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 5 di 11
3.1. Record
“00” (record di testa)
Prog.
Descrizione
1
2
3
Filler
Tipo record
campagna
4
cuaa azienda
dichiarante
regione di
riferimento
cuaa
rappresentante
legale
progressivo
fornitura
Data di riferimento giorno
Data di riferimento mese
Data di riferimento anno
Filler
5
6
7
8
9
10
11
3.2. Record
da
col.
1
19
21
a
col.
18
20
24
Tipo
Lung.
Note
an
an
an
18
2
4
25
40
an
16
= spazio
= 00
Anno campagna per cui importare
i dati
CUAA cantina
41
42
an
2
= 08
43
58
an
16
Non usato
59
61
n
3
Non usato
62
63
n
2
64
65
n
2
66
69
n
4
70
350
an
281
= spazio
“60” (socio)
Prog.
Descrizione
da
col.
1
a
col.
16
Tipo
Lung.
Note
1
CUAA fornitore
an
16
Codice ISTAT della regione dove avviene la
raccolta uva
17
18
n
2
CUAA
socio
Non
usato
2
3
4
Tipo record
Filler
19
21
20
97
an
an
2
77
5
Flag sostituzione
98
98
an
1
6
Data di riferimento - giorno
99
100
n
2
7
Data di riferimento - mese
101
102
n
2
8
Data di riferimento - anno
103
106
n
4
9
Filler
107
350
an
244
Note: La data di riferimento deve essere impostata sulla base del possesso delle UNAR utilizzate.
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 6 di 11
= 60
=
spazio
Non
usato
=
spazio
3.3. Record
“64” (IG/DO rivendicate)
Prog.
Descrizione
da
col.
1
a
col.
16
Tipo
Lung.
Note
1
CUAA fornitore
an
16
Codice ISTAT della regione
dove avviene la raccolta uva
17
18
n
2
3
4
Tipo record
Tipo allegato
19
21
20
22
an
an
2
2
5
Tipo vino
23
23
an
1
6
Codice varietà
24
26
an
3
7
Codice denominazione a 9
carat-teri
27
35
an
9
8
Codice denominazione a 14
carat-teri
36
49
an
14
Cuaa Cantina o socio
(se vigneto da unar F2),
conduttore delle UNAR
che compongono il
vigneto
Se codice diverso da
“08”, vigneto da “fuori
regione" (non ci sono
UNAR, solo dati del
vigneto)
= 64
'C1' vini senza
menzioni, 'C2' vini con
indicazione della
varietà, 'C3' vini IG, 'C8'
vini DO
Solo per vini C1 e C2. =
B per vini bianchi (C1),
= N per vini rossi (C1),
= V per vini varietali
(C2), = S per spumanti
varietali (C2) . Spazio in
caso di (C3 e C8)
Solo per vini/spumanti
varietali (C2)
Per vini IG/DO (C3 e
C8): opzionale.
Per vini/spumanti
varietali (C2):
opzionale, utilizzato per
determinare la
vinificazione in caso di
vinificazioni multiple per
singolo vino varietale.
Solo per vini IG/DO (C3
e C8) - obbligatorio
2
9
Toponimo
50
99
an
50
10
100
102
n
3
11
Resa indicata nel disciplinare
(q.li / ha) – se ridotta dalla
Regione va indicata quella
ridotta.
Presenza superi
103
103
an
1
Non usato
12
Quantità uva rivendicata
104
113
n
10
In chilogrammi
13
Quantità massima uva
rivendicabile
Supero destinato a vini senza
menzioni
114
123
n
10
Non usato
124
133
n
10
Non usato
14
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Solo per vini DO (C8) se presente
Solo per vini DO (C3 e
C8)
Pagina 7 di 11
15
Supero destinato a vini varietali
134
143
n
10
Non usato
16
Supero destinato a vini IG
144
153
n
10
Non usato
17
Supero destinato a vini DO
154
163
n
10
Non usato
18
Uva vinificata in proprio
164
173
n
10
Non usato
19
20
21
174
184
194
183
193
195
n
an
n
10
10
2
Non usato
Non usato
Non usato
196
205
n
10
Non usato
23
Uva ceduta
Altre destinazioni
Coeff. di trasformazione indicato
nel disciplinare (litri per q.le)
Quantità massima vino
rivendica-bile
Ragione sociale fornitore
206
255
an
50
24
Identificativo vigneto
256
260
n
5
25
Supero di
261
265
n
5
26
Area
266
275
n
10
27
Filler
276
350
an
75
Ragione sociale socio
nel caso di F2 da fuori
regione
Numerazione univoca
del vigneto per
collegarlo alle sue
UNAR
= identificativo vigneto
“padre” nel caso questo
vigneto sia un supero.
Altrimenti tutti 0.
Area del lotto SOLO in
caso di lotto da fuori
regione (altrimenti
calcolata da area
UNAR)
= spazio
22
3.4. Record
“66” (unità vitate utilizzate nelle rivendicazioni)
Prog.
Descrizione
da
col.
1
a
col.
16
Tipo
Note
an
Lun
g.
16
1
Codice fiscale fornitore
2
17
3
4
Codice ISTAT della regione
dove avviene la raccolta uva
Tipo record
Tipo allegato
18
n
2
Non usato
19
21
20
22
an
an
2
2
= 66
Non usato
5
Tipo vino
23
23
an
1
Non usato
6
Codice varietà
24
26
an
3
Non usato
7
Codice denominazione a 9
caratteri
27
35
an
9
Non usato
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Non usato
Pagina 8 di 11
8
Codice denominazione a 14
caratteri
36
49
an
14
Non usato
9
Toponimo
50
99
an
50
Non usato
10
Codice istat provincia
100
102
an
3
11
Codice istat comune
103
105
an
3
12
13
14
15
16
17
18
Sezione
Foglio
Particella
Subalterno
Casi particolari
UNAR
Codice univoco vitata
106
107
112
117
122
123
126
106
111
116
121
122
125
131
an
n
an
an
an
n
n
1
5
5
5
1
3
6
Non usato
Obbligatorio
Non usato
19
20
21
22
23
Codice varietà
Anno impianto
Mese impianto
Produttività
Resa utilizzata per ettaro
132
135
139
141
144
134
138
140
143
146
n an
n
n
n
n
3
4
2
3
3
Sempre obbligatorio
Non usato
Non usato
Non usato
Non usato
24
Superficie rivendicata
147
156
n
10
In metri quadrati
25
Identificativo vigneto
157
161
n
5
26
Filler
162
350
an
189
Identificativo del vigneto
a cui appartengono le
UNAR
= spazio
3.5. Record
“51” (cessioni di uva tramite F1, in uscita)
Prog.
Descrizione
1
2
filler
Codice ISTAT della
regione del destinatario
della cessione
Tipo record
Identificativo vigneto
3
4
da
col.
1
17
a
col.
16
18
Tipo
Lung.
Note
an
n
16
2
19
21
20
25
an
n
2
5
= spazio
Se codice diverso “08”=
cessione a “fuori regione"
Se 99 = estero
= 51
Identificativo vigneto ceduto
5
6
CUAA destinatario
Ragione sociale
destinatario
26
42
41
91
an
an
16
50
7
Quantità uva ceduta
92
101
n
10
Ragione sociale destinatario
(nel caso di cessione a fuori
regione o estero)
In chilogrammi
8
9
Conto lavorazione
Filler
102
103
102
350
n
an
1
248
1 = si , 0 = no
= spazio
Note: non sono ammesse cessioni multiple dello stesso vigneto allo stesso CUAA
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 9 di 11
3.6. Record
“99” (record di coda)
Prog.
1
2
3
4
Descrizione
Filler
Tipo record
campagna
numero record '60' forniti
da col.
1
19
21
37
a col.
18
20
36
46
Tipo
an
an
an
n
Lung.
18
2
16
10
5
numero record '64' forniti
47
56
n
10
6
numero record '66' forniti
57
66
n
10
7
numero record '51' forniti
67
76
n
10
8
Filler
77
350
an
274
Note
tutti '9'
= 99
= spazio
4. STRUTTURA DEL FILE
Il file contenente i dati da importare dovrà essere strutturato come segue:
1 record di testa (tipo 00)
N records tipo: 60, 64, 66, 51
1 record di coda (tipo 99)
•
•
•
•
•
•
Ogni invio deve essere relativo ad una sola dichiarazione.
La fornitura deve obbligatoriamente contenere il record tipo 00, in cui sono riportati i dati anagrafici delle
cantina.
Ogni record dovrà occupare una singola riga del file.
Dopo il record di coda non deve essere registrata alcuna altra informazione.
I campi alfanumerici vanno allineati a sinistra con riempimento a spazi della parte non significativa ed in
caso di assenza del dato essi devono essere impostati completamente a spazi, inoltre, non devono
contenere nessun carattere speciale.
I campi numerici vanno allineati a destra e riempiti di zeri nella parte non significativa; se il dato è
mancante il campo deve essere impostato completamente a zeri.
5. CARICAMENTO TOTALE E PARZIALE
5.1. Totale
Il caricamento totale dei dati prevede la cancellazione dei dati già presenti a sistema per la cantina
interessata. In caso non sia possibile annullare tali dati (ad esempio se sono presenti moduli F1 già
consegnati ufficialmente) questo tipo di caricamento non potrà essere eseguito.
5.2. Parziale
Il sistema ammetterà anche un caricamento parziale dei dati, che verranno aggiunti a quelli già esistenti. In
questo caso il file contenente i dati dovrà rispettare le seguenti restrizioni:
• I record 60 saranno accettati solo se il soggetto a cui fanno riferimento non ha ancora vigneti definiti
• I record 51 dovranno essere relativi ai record 64 presenti nel file (ovvero, nessuna cessione F1 di
vigneti già importati in precedenza)
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 10 di 11
6. ESITO DEL CARICAMENTO
L’operazione di caricamento produrrà un file di testo strutturato come segue:
Prog.
1
2
3
Descrizione
Codice di errore
Riga errore
Messaggio errore
da col.
1
6
11
a col.
5
10
1010
Tipo
n
n
an
Lung.
5
5
1000
Note
L’intero file verrà analizzato per “entità consistenti” (socio, vigneto con relative unar e cessioni, ecc…). Le
entità prive di errori verranno caricate a sistema, quelle con errori verranno segnalate nel file generato in
output.
Versione 2.1
Del 20/11/2014
ABACO S.p.A.
RISERVATO FORNITORE – Tutti i diritti riservati
Pagina 11 di 11