Step 1 – Archivio tipi utente

Aggiornato al 6 novembre 2026

L'archivio elenca i 15 tipi di operatore della filiera ittica che l'applicazione dovrà riconoscere. Ogni tipo determina quali documenti l'utente produce, riceve e conserva, secondo gli obblighi descritti nel perimetro normativo. Un'azienda reale può avere più tipi (es. un armatore che vende direttamente, un grossista che importa).

Tipi di operatore

Codice	Tipo utente	Fase	Documenti principali	Chi lo controlla
UT01	Armatore / comandante peschereccio (≥ 12 m)	1 Cattura	Licenza di pesca, giornale di pesca elettronico, dichiarazione di sbarco e di trasbordo, notifica preventiva	Guardia Costiera, MASAF
UT02	Pescatore della piccola pesca costiera (< 12 m)	1 Cattura	Licenza, giornale di pesca semplificato, dati di vendita diretta	Guardia Costiera
UT03	Acquacoltore (pesci e crostacei)	1 Allevamento	Registrazione impianto, registro trattamenti e farmaci, movimentazioni, dati di lotto	ASL, Guardia Costiera
UT04	Molluschicoltore / raccoglitore di bivalvi	1 Allevamento	Documento di registrazione della partita, classificazione della zona di produzione	ASL, Guardia Costiera
UT05	Mercato ittico all'ingrosso / asta	2 Prima vendita	Registri di pesatura e vendita, note di vendita, creazione lotti	Guardia Costiera, ASL
UT06	Primo acquirente registrato	2 Prima vendita	Nota di vendita elettronica, dichiarazione di presa in carico	Guardia Costiera, MASAF
UT07	Centro di depurazione o spedizione molluschi (CDM/CSM)	3 Lavorazione	Etichetta di identificazione, registri di depurazione, esiti analitici	ASL
UT08	Stabilimento di lavorazione e trasformazione	3 Lavorazione	Piano HACCP, registri temperature e bonifica parassiti, etichette con bollo sanitario, collegamento lotti in entrata e uscita	ASL, ICQRF, NAS
UT09	Grossista / deposito frigorifero	4 Distribuzione	Documenti di trasporto, dati di lotto digitali, registri della catena del freddo	Guardia Costiera, ASL
UT10	Trasportatore refrigerato	4 Distribuzione	Documenti di trasporto, registrazioni di temperatura	ASL
UT11	Importatore	4 Importazione	Certificato di cattura in CATCH, dichiarazione di trasformazione, CHED-P in TRACES, documenti doganali	PCF Min. Salute, Dogane, Guardia Costiera
UT12	Esportatore	4 Esportazione	Certificati sanitari di esportazione, certificati di cattura per il paese di destinazione	ASL, Guardia Costiera
UT13	Dettagliante (pescheria, GDO)	5 Vendita	Etichette e cartelli art. 35, cartello Anisakis, etichette molluschi conservate 60 giorni, documenti fornitori	ASL, Guardia Costiera, ICQRF
UT14	Ristoratore / ristorazione collettiva	6 Ristorazione	Piano HACCP, registro di abbattimento, menu con indicazione dei congelati, informazioni allergeni, documenti fornitori	ASL, NAS
UT15	Pescatore ricreativo	1 Cattura	Registrazione elettronica delle catture (senza vendita)	Guardia Costiera

Archivio unico: utenti WordPress

Ogni operatore della filiera è un utente WordPress. Il tipo di anagrafica e tutti i dati sono salvati come metadati dell'utente (wp_usermeta), con chiavi che iniziano per fi_. Non esistono altri archivi anagrafici.

Ruoli WordPress: fi_operatore per gli operatori; fi_gestore per chi configura i tipi di anagrafica dal front end; fi_controllore in sola lettura per autorità o consulenti; gli amministratori restano administrator.
Tipo di anagrafica: metadato fi_tipo_utente, a spunte multiple. Il profilo mostra solo i campi dei tipi spuntati.
Schede ripetibili (imbarcazioni, impianti, punti vendita, automezzi, magazzini): elenco di schede dentro il metadato corrispondente, ognuna con un proprio codice per collegarla ai documenti.
Stato dell'anagrafica: tendina fi_stato_verifica (Da verificare, Verificata, Sospesa). Un operatore non verificato non può emettere documenti.

Tipi di anagrafica configurabili dal front end

I 15 tipi descritti sotto sono la configurazione iniziale, non uno schema fisso. Un utente con ruolo fi_gestore li modifica da una pagina del sito, senza toccare codice.

Cosa si può fare: creare un nuovo tipo, rinominarlo, disattivarlo; aggiungere, modificare, riordinare o nascondere campi; cambiare le voci di una tendina o di un gruppo di spunte; segnare un campo come obbligatorio.
Dove sono salvati: ogni tipo è un contenuto WordPress fi_tipo_anagrafica con codice, nome, fase della filiera, stato (attivo/disattivo) e l'elenco dei suoi campi.
Definizione di un campo: etichetta, chiave, formato (tendina, spunta, spunte multiple, testo, numero, data, email, file, schede ripetibili), voci disponibili per tendine e spunte, obbligatorio sì/no, condizione di visibilità (es. "solo se Serve pesce crudo = sì"), ordine.
Regola di sicurezza: un campo già compilato da qualche operatore non si cancella ma si disattiva, così i dati esistenti non vanno persi.

Formati usati, in ordine di preferenza: tendina (una scelta), spunte (più scelte), spunta (sì/no); poi numero, data, email, file; testo libero solo per codici e nomi propri.

Anagrafica comune a tutti i tipi

Campo	Chiave	Formato	Obbligatorio
Nome utente (accesso)	`user_login` (nativo WP)	testo	Sì
Email di accesso	`user_email` (nativo WP)	email	Sì
Nome e cognome del referente	`first_name`, `last_name` (nativi WP)	testo	Sì
Tipo di anagrafica	`fi_tipo_utente`	spunte: tipi attivi	Sì
Natura del soggetto	`fi_natura`	tendina: impresa, ente, persona fisica	Sì
Ragione sociale	`fi_ragione_sociale`	testo	Se impresa o ente
Forma giuridica	`fi_forma_giuridica`	tendina: ditta individuale, SNC, SAS, SRL, SRLS, SPA, cooperativa, consorzio, altro	Se impresa
Partita IVA	`fi_partita_iva`	testo (11 cifre, controllata)	Se impresa
Codice fiscale	`fi_codice_fiscale`	testo (controllato)	Sì
Numero REA	`fi_rea`	testo	Se impresa
Sede: indirizzo, CAP, comune	`fi_sede_indirizzo`, `fi_sede_cap`, `fi_sede_comune`	testo	Sì
Sede: provincia	`fi_sede_provincia`	tendina: sigle province	Sì
Regione	`fi_regione`	tendina: regioni italiane	Sì
PEC	`fi_pec`	email	Se impresa
Codice destinatario SDI	`fi_sdi`	testo (7 caratteri)	No
Telefono	`fi_telefono`	testo	Sì
Legale rappresentante: nome e codice fiscale	`fi_legale_rapp_nome`, `fi_legale_rapp_cf`	testo	Se impresa
Ha un codice GLN GS1	`fi_gln_presente`	spunta	No
Codice GLN	`fi_gln`	testo (13 cifre)	Se spuntato sopra
Stato dell'anagrafica	`fi_stato_verifica`	tendina: da verificare, verificata, sospesa	Sì (solo gestore)
Consenso privacy	`fi_privacy`	spunta, con data salvata in automatico	Sì

Campi specifici per tipo

UT01 – Armatore / comandante peschereccio (≥ 12 m)

Schede ripetibili imbarcazione (fi_imbarcazioni).

Campo	Chiave	Formato	Obbligatorio
Numero flotta UE (CFR)	`cfr`	testo (es. ITA000012345)	Sì
Nome imbarcazione	`nome`	testo	Sì
Matricola	`matricola`	testo	Sì
Ufficio di iscrizione (compartimento marittimo)	`compartimento`	tendina: compartimenti marittimi	Sì
Numero IMO / UVI	`imo`	testo	Se assegnato
Nominativo internazionale (IRCS)	`ircs`	testo	Sì
Classe di lunghezza	`classe_lft`	tendina: < 9 m, 9–12 m, 12–15 m, 15–18 m, > 18 m	Sì
Lunghezza fuori tutto	`lft_m`	numero (m)	Sì
Stazza	`gt`	numero (GT)	Sì
Potenza motore	`kw`	numero (kW)	Sì
Porto di base	`porto_base`	tendina: porti	Sì
Licenza di pesca: numero e scadenza	`licenza_n`, `licenza_scadenza`	testo, data	Sì
Attrezzi autorizzati	`attrezzi`	spunte: strascico (OTB), volante (PTM), circuizione (PS), draga idraulica (HMD), rapido (TBB), reti da posta (GNS/GTR), palangari (LLS/LLD), nasse (FPO), lenze (LHP)	Sì
Sistemi a bordo	`sistemi_bordo`	spunte: VMS, giornale elettronico (ERS), AIS, telecamere	Sì
Identificativo VMS	`vms_id`	testo	Se VMS spuntato
Comandante: nome e codice fiscale	`comandante_nome`, `comandante_cf`	testo	Sì

UT02 – Pescatore della piccola pesca costiera (< 12 m)

Stessa scheda imbarcazione di UT01, con IMO, IRCS e VMS non obbligatori sotto i 9 metri fino al 31/12/2029. In più:

Campo	Chiave	Formato	Obbligatorio
Giornale di pesca semplificato	`fi_giornale_semplificato`	tendina: app UE, app nazionale, altro sistema	Sì
Vende direttamente al consumatore	`fi_vendita_diretta`	spunta	Sì
Dove vende direttamente	`fi_vendita_diretta_luogo`	tendina: in banchina, mercato, a domicilio, altro	Se spuntato sopra

UT03 – Acquacoltore (pesci e crostacei)

Schede ripetibili impianto (fi_impianti).

Campo	Chiave	Formato	Obbligatorio
Codice aziendale / registrazione sanitaria	`codice_aziendale`	testo	Sì
Tipo di impianto	`tipo`	tendina: vasche a terra, gabbie in mare, valle da pesca, laguna, altro	Sì
Ubicazione	`indirizzo`, `lat`, `lon`	testo, numero	Sì
Titolo d'uso	`titolo`	tendina: concessione demaniale, autorizzazione, proprietà	Sì
Numero e scadenza del titolo	`titolo_n`, `titolo_scadenza`	testo, data	Sì
Specie allevate	`specie`	spunte: orata, spigola, trota, ombrina, anguilla, gamberi, altro	Sì
Capacità produttiva	`capacita`	tendina: < 10 t, 10–100 t, 100–1.000 t, > 1.000 t/anno	Sì
Veterinario di riferimento	`veterinario`	testo	Sì

UT04 – Molluschicoltore / raccoglitore di bivalvi

Schede ripetibili area di produzione (fi_aree_produzione).

Campo	Chiave	Formato	Obbligatorio
Codice zona di produzione	`codice_zona`	testo	Sì
Classificazione sanitaria	`classe`	tendina: A, B, C	Sì
Concessione: numero e scadenza	`concessione_n`, `concessione_scadenza`	testo, data	Sì
Specie	`specie`	spunte: mitili, vongole veraci, vongole, ostriche, fasolari, cannolicchi, altro	Sì
Modalità di raccolta	`raccolta`	spunte: da barca, a mano, con draga	Sì
Imbarcazioni usate	`imbarcazioni`	spunte: imbarcazioni dello stesso utente	Se raccolta da barca
Centro di conferimento abituale	`centro_conferimento`	tendina: utenti UT07	Sì

UT05 – Mercato ittico all'ingrosso / asta

Campo	Chiave	Formato	Obbligatorio
Numero di riconoscimento CE	`fi_riconoscimento_ce`	testo	Sì
Ente gestore	`fi_ente_gestore`	testo	Sì
Registrato come centro d'asta	`fi_centro_asta`	spunta	Sì
Numero registrazione centro d'asta	`fi_centro_asta_n`	testo	Se spuntato sopra
Sistema di vendita	`fi_sistema_vendita`	spunte: asta elettronica, asta a voce, trattativa privata	Sì
Sistemi di pesatura	`fi_bilance`	schede ripetibili (identificativo, data ultima verifica)	Sì
Porti serviti	`fi_porti_serviti`	spunte: porti	Sì

UT06 – Primo acquirente registrato

Campo	Chiave	Formato	Obbligatorio
Numero di registrazione come primo acquirente	`fi_primo_acquirente_n`	testo	Sì
Invio note di vendita	`fi_note_vendita_sistema`	tendina: sistema nazionale, gestionale proprio, tramite mercato	Sì
Ha magazzini propri	`fi_ha_magazzini`	spunta	Sì
Magazzini	`fi_magazzini`	schede ripetibili (indirizzo, tipo: tendina refrigerato/congelato)	Se spuntato sopra

UT07 – Centro di depurazione o spedizione molluschi (CDM/CSM)

Campo	Chiave	Formato	Obbligatorio
Numero di riconoscimento CE	`fi_riconoscimento_ce`	testo	Sì
Tipo di centro	`fi_tipo_centro`	tendina: CDM, CSM, entrambi	Sì
Capacità di depurazione	`fi_capacita_kg`	numero (kg per ciclo)	Se CDM
Specie trattate	`fi_specie`	spunte: come UT04	Sì
Laboratorio analisi di riferimento	`fi_laboratorio`	testo	Sì

UT08 – Stabilimento di lavorazione e trasformazione

Campo	Chiave	Formato	Obbligatorio
Numero di riconoscimento CE (bollo sanitario)	`fi_riconoscimento_ce`	testo	Sì
Indirizzo stabilimento	`fi_stabilimento_indirizzo`	testo	Sì
Attività	`fi_attivita`	spunte: sfilettatura, congelamento, affumicatura, marinatura, salagione, conserve, cottura, confezionamento	Sì
Categorie di prodotto	`fi_categorie`	spunte: pesce fresco, congelato, molluschi, crostacei, prodotti trasformati	Sì
Tratta prodotto per il consumo crudo	`fi_crudo`	spunta	Sì
Impianti di abbattimento o congelamento	`fi_abbattitori`	schede ripetibili (modello, temperatura minima, capacità)	Se spuntato sopra
Responsabile HACCP	`fi_resp_haccp`	testo	Sì

UT09 – Grossista / deposito frigorifero

Campo	Chiave	Formato	Obbligatorio
Registrazione o riconoscimento sanitario	`fi_registrazione_sanitaria`	testo	Sì
Tipo di attività	`fi_tipo_ingrosso`	spunte: commercio all'ingrosso, deposito conto terzi, piattaforma logistica	Sì
Magazzini	`fi_magazzini`	schede ripetibili (indirizzo, tipo: tendina refrigerato/congelato/entrambi)	Sì
Tracciabilità digitale	`fi_sistema_tracciabilita`	tendina: questa applicazione, gestionale proprio con standard GS1, altro	Sì

UT10 – Trasportatore refrigerato

Campo	Chiave	Formato	Obbligatorio
Iscrizione Albo autotrasportatori	`fi_albo_autotrasporto`	testo	Sì
Registrazione sanitaria	`fi_registrazione_sanitaria`	testo	Sì
Automezzi	`fi_automezzi`	schede ripetibili (targa, certificato ATP n., classe ATP: tendina FRA/FRC/FNA…, scadenza)	Sì
Registratori di temperatura a bordo	`fi_datalogger`	spunta	Sì

UT11 – Importatore

Campo	Chiave	Formato	Obbligatorio
Codice EORI	`fi_eori`	testo	Sì
Identificativo operatore TRACES / CATCH	`fi_traces_id`	testo	Sì
Registrazione sanitaria	`fi_registrazione_sanitaria`	testo	Sì
Posti di controllo frontalieri usati	`fi_pcf`	spunte: posti di controllo frontalieri italiani	Sì
Usa uno spedizioniere doganale	`fi_spedizioniere_si`	spunta	No
Spedizioniere	`fi_spedizioniere`	testo	Se spuntato sopra
Paesi di origine abituali	`fi_paesi_origine`	spunte: paesi	No

UT12 – Esportatore

Campo	Chiave	Formato	Obbligatorio
Codice EORI	`fi_eori`	testo	Sì
Identificativo operatore TRACES	`fi_traces_id`	testo	Sì
Paesi di destinazione	`fi_paesi_destinazione`	spunte: paesi	Sì
Abilitazioni per paesi terzi	`fi_abilitazioni_export`	schede ripetibili (paese: tendina, numero lista, scadenza)	Se richieste

UT13 – Dettagliante (pescheria, GDO)

Schede ripetibili punto vendita (fi_punti_vendita).

Campo	Chiave	Formato	Obbligatorio
Insegna	`insegna`	testo	Sì
Tipo di esercizio	`tipo`	tendina: pescheria, banco GDO, ambulante, mercato rionale	Sì
Indirizzo	`indirizzo`	testo	Sì
Registrazione sanitaria (notifica)	`registrazione_sanitaria`	testo	Sì
Prodotti in vendita	`prodotti`	spunte: fresco, congelato, decongelato, molluschi vivi, preparati	Sì
Vende prodotti per il consumo crudo	`crudo`	spunta	Sì
Cartello Anisakis esposto	`cartello_anisakis`	spunta	Sì
Responsabile HACCP	`resp_haccp`	testo	Sì

UT14 – Ristoratore / ristorazione collettiva

Schede ripetibili locale (fi_locali).

Campo	Chiave	Formato	Obbligatorio
Insegna	`insegna`	testo	Sì
Tipo	`tipo`	tendina: ristorante, sushi, mensa, catering, altro	Sì
Indirizzo	`indirizzo`	testo	Sì
Registrazione sanitaria (notifica)	`registrazione_sanitaria`	testo	Sì
Serve pesce crudo o marinato	`crudo`	spunta	Sì
Come bonifica il crudo	`bonifica`	tendina: abbattitore proprio, acquista già abbattuto, entrambi	Se serve crudo
Abbattitore: modello e capacità	`abbattitore`	testo	Se abbattitore proprio
Procedura comunicata all'ASL	`abbattimento_comunicato`	spunta, con data	Se richiesto dalla regione
Usa prodotti congelati	`congelati`	spunta (attiva l'asterisco in menu)	Sì
Responsabile HACCP	`resp_haccp`	testo	Sì

UT15 – Pescatore ricreativo

Valgono solo i campi comuni da persona fisica.

Campo	Chiave	Formato	Obbligatorio
Registrazione come pescatore ricreativo	`fi_pesca_ricreativa_n`	testo	Sì
Tipo di pesca	`fi_tipo_ricreativa`	spunte: da terra, da barca, subacquea	Sì
Usa un'imbarcazione da diporto	`fi_diporto`	spunta	No

Da decidere

Utenti in sola lettura (autorità, consulenti, laboratori, consumatore tramite QR): confermare il ruolo fi_controllore e cosa può vedere.
Elenchi di valori da caricare all'avvio (compartimenti marittimi, porti, posti di controllo frontalieri, specie con codici FAO): da quali fonti ufficiali prenderli.
Strumento per i campi configurabili: plugin di campi personalizzati già esistente o plugin sviluppato su misura.
Verifica delle anagrafiche: chi la esegue e quali documenti chiede all'operatore.