Come si usa TARGA, passo per passo

01Dati azienda e firmatario

In Impostazioni inserisci ragione sociale, indirizzo, logo, contatti per l'assistenza e la persona autorizzata a firmare le dichiarazioni UE di conformità, con il suo ruolo. Indica anche il luogo usato nelle dichiarazioni.

Questi dati compaiono sulla pagina pubblica di ogni matricola e nelle dichiarazioni generate dal template.

02Modello e opzioni (varianti)

Crea un modello per ogni famiglia di macchina, con un codice (ad esempio PX200), la lingua delle istruzioni originali e le norme armonizzate applicate. Se è prevedibile l'uso da parte di utilizzatori non professionali, attiva l'apposito indicatore.

Le varianti si descrivono con gruppi di opzioni e valori, ciascuno con un codice. Esempio: gruppo COMANDO con valori DUE_MANI e PEDALE, gruppo TENSIONE con 230V e 400V. Gli stessi codici si usano nelle condizioni dei blocchi e nell'import.

03Blocchi del manuale

Il manuale non è un documento unico ma una sequenza di blocchi strutturati, ordinati in sezioni. Per ogni blocco scegli:

• la sezione in cui compare (avvertenze, installazione, uso, manutenzione e così via);
• il tipo: testo, passi numerati, tabella di dati tecnici, immagine oppure avvertenza con il suo livello (pericolo, avvertenza, attenzione, nota);
• le condizioni per variante: il blocco compare solo se la matricola ha certi valori, ad esempio COMANDO = PEDALE. Senza condizioni il blocco vale per tutte le configurazioni;
• se fa parte delle informazioni essenziali di sicurezza, da fornire su carta quando la macchina può essere usata da utilizzatori non professionali.

Con l'anteprima scegli una configurazione dal menu e vedi subito il manuale che riceverà quella macchina.

04Traduzioni AI, revisione e glossario

Per ogni lingua richiesta il sistema individua i segmenti mancanti. Quelli già tradotti e approvati in passato si riusano dalla memoria di traduzione; gli altri vengono tradotti con l'AI usando il tuo glossario (termini obbligatori e termini vietati per lingua).

Dopo la traduzione, controlli automatici segnalano numeri, unità di misura o segnaposto diversi dal testo originale, parole di segnalazione non coerenti con il glossario e lunghezze anomale. Nella schermata di revisione vedi originale e traduzione affiancati e puoi approvare, correggere o rifiutare.

Una lingua si pubblica solo quando tutti i suoi segmenti sono approvati da una persona. Ogni approvazione resta nel registro di audit.

05Matricola

Ogni macchina venduta è una matricola. Per crearla indichi:

• numero di matricola e modello;
• configurazione, cioè un valore per ogni gruppo di opzioni;
• lingue del manuale e mercati di destinazione (l'italiano è sempre richiesto per l'Italia);
• data di immissione sul mercato, da cui decorre il periodo minimo di conservazione di 10 anni;
• anno di costruzione e, se vuoi, il cliente con la sua email.

Le matricole si creano a mano, da CSV o via API (vedi il passo 12).

06Pubblicazione

Prima di pubblicare, TARGA esegue i controlli e mostra cosa blocca la pubblicazione, ad esempio traduzioni non approvate o dati azienda mancanti.

Alla pubblicazione genera per ogni lingua la versione HTML e il PDF, calcola l'impronta SHA-256 e la registra nel registro di audit. La versione pubblicata è immutabile: per correggerla si pubblica una nuova versione, e la pagina pubblica mostra sempre quella corrente con lo storico delle precedenti. Insieme al manuale viene generata la dichiarazione UE di conformità.

07QR ed etichette

Ogni matricola ha un indirizzo breve stabile e un QR. Dalla matricola, o selezionandone più di una, scarichi un PDF di etichette con QR, indirizzo leggibile, numero di matricola e la frase di accesso alle istruzioni nella lingua del Paese di destinazione. Puoi stamparle sulla targhetta, sull'imballaggio o su un documento allegato.

08Materiali e stampa delle etichette

L'etichetta con il QR deve restare leggibile per tutta la vita della macchina, spesso in officina, con polvere, oli e luce scarsa. Alcuni consigli pratici, validi per qualsiasi stampante o fornitore di etichette:

• Materiali durevoliPer un'etichetta che resta sulla macchina usa etichette in poliestere o in alluminio anodizzato, oppure la marcatura laser direttamente sulla targhetta. La carta non dura.
• Dimensione minima del QRTieni il QR intorno ai 15-20 mm di lato come minimo, con una zona di rispetto libera di almeno 2 mm tutto intorno, senza testo o bordi che la invadano.
• Niente laminati lucidiEvita le finiture lucide che riflettono la luce: in officina rendono difficile la lettura con il telefono. Preferisci finiture opache.
• Prova di scansione prima della spedizioneInquadra il QR con un telefono, possibilmente nella luce reale del reparto, e verifica che si apra la pagina della matricola giusta.
• Stampa al 100%, senza marginiStampa il PDF delle etichette in scala reale, senza adattamento alla pagina e senza margini aggiunti dalla stampante, così le misure del QR restano quelle previste.

Le indicazioni sono generali: per ambienti particolari (temperature elevate, solventi, esterno) verifica la scelta del materiale con il fornitore delle etichette.

09Richieste di copia cartacea

Dalla pagina pubblica l'acquirente può chiedere la copia su carta. La richiesta arriva nel back office con la scadenza a 30 giorni e un semaforo: verde se mancano più di 10 giorni, giallo da 10 a 3, rosso sotto i 3 o se scaduta.

Ricevi un'email per ogni nuova richiesta e i promemoria prima della scadenza. Con "stampa pacchetto" ottieni un unico PDF nella lingua richiesta; quando la copia è spedita, segni la richiesta come evasa.

10Storico del software

Per ogni matricola registri le versioni del software di sicurezza installate nel tempo: componente, versione, impronta SHA-256, data e note. Lo storico è visibile sulla pagina pubblica e incluso negli export. Puoi aggiungere le versioni a mano o via API.

11Export per ispezione e copia di continuità

L'export per ispezione produce un archivio ZIP per matricola o per modello con i documenti pubblicati, le dichiarazioni, lo storico del software in CSV, il registro di audit filtrato e un manifest.json con le impronte e le istruzioni per verificarle.

La copia di continuità è un export statico completo (sito HTML navigabile offline, PDF e manifest) da conservare in azienda: garantisce l'accesso ai documenti anche in caso di interruzione del servizio.

12Import da CSV e API

Import CSV

File con separatore punto e virgola e una riga di intestazione. Colonne: matricola, modello, lingue, mercati, data_immissione, anno, cliente, email_cliente, più una colonna per ogni codice di gruppo di opzioni con il codice del valore scelto. Lingue e mercati si separano con la virgola. Le date sono nel formato AAAA-MM-GG.

matricola;modello;lingue;mercati;data_immissione;anno;cliente;email_cliente;COMANDO;TENSIONE
PX200-0142;PX200;it,en,de;IT,DE,AT;2027-03-12;2027;Cliente di esempio S.r.l.;acquisti@cliente.example;DUE_MANI;400V

Al termine ricevi un report con gli errori riga per riga. Il numero di matricola rende l'import ripetibile senza creare doppioni.

API

Genera una chiave API in Impostazioni e inviala nell'intestazione Authorization: Bearer <chiave>. Tieni la chiave riservata: chi la possiede può creare matricole nel tuo spazio.

Creare o aggiornare una matricola: POST /api/v1/serials. Campi JSON: serialNumber, modelCode, configuration (oggetto con codice gruppo e codice valore), languages, markets, placedOnMarketAt (AAAA-MM-GG), yearOfConstruction, customerName, customerEmail.

POST /api/v1/serials
Authorization: Bearer <chiave>
Content-Type: application/json

{
  "serialNumber": "PX200-0142",
  "modelCode": "PX200",
  "configuration": { "COMANDO": "DUE_MANI", "TENSIONE": "400V" },
  "languages": ["it", "en", "de"],
  "markets": ["IT", "DE", "AT"],
  "placedOnMarketAt": "2027-03-12",
  "yearOfConstruction": 2027,
  "customerName": "Cliente di esempio S.r.l.",
  "customerEmail": "acquisti@cliente.example"
}

Registrare una versione software: POST /api/v1/serials/{serialNumber}/software con i campi component, version, sha256, notes.

POST /api/v1/serials/PX200-0142/software
Authorization: Bearer <chiave>
Content-Type: application/json

{
  "component": "PLC sicurezza",
  "version": "2.4.1",
  "sha256": "9f2c...a41e",
  "notes": "Aggiornamento della funzione di arresto"
}

13Utenti e ruoli

Invita i colleghi via email e assegna a ciascuno un ruolo:

Hai bisogno di aiuto? Scrivici.