File di output personalizzato
Introduzione
L’estensione File di output personalizzato permette di adattare i dati esportati da Retica al tracciato richiesto dal gestionale aziendale.
Per ogni modello puoi scegliere:
- quali informazioni esportare;
- come nominare le colonne;
- in quale ordine mostrarle;
- se mantenere una struttura fissa anche quando alcuni dati non vengono estratti.
Una volta salvata la configurazione, Retica applicherà automaticamente il tracciato personalizzato a tutti i nuovi documenti elaborati con quel modello.
Abilitazione dell’estensione
Prima di configurare il file di output, verifica che l’estensione sia attiva:
1. Apri la sezione Estensioni dal menu laterale.
2. Premi Aggiungi estensione.

3. Seleziona File output personalizzato.

4. Conferma l’attivazione.

Una volta attivata, individua l’estensione nell’elenco, premi Opzioni e seleziona Informazioni per accedere alla configurazione.
Selezione e mappatura dei modelli
La pagina mostra tutti i modelli disponibili nell’account, suddivisi in:
- Modelli standard: modelli preconfigurati di Retica, come Ordini, DDT e Fatture.

- Modelli personalizzati: modelli creati e addestrati per documenti specifici.

- Modelli generativi: modelli che utilizzano l’intelligenza artificiale generativa per leggere documenti con strutture variabili.

Accanto a ogni modello è presente un interruttore:
- Disattivato: Retica utilizza il file di output standard del modello.
- Attivato: Retica utilizza il tracciato personalizzato configurato.
Per modificare la struttura dell’output di un modello, premi il pulsante con la freccia presente sulla relativa riga.
Opzioni avanzate
Abilita l’output personalizzato per questo modello
Nella parte superiore dell’interfaccia è possibile attivare due parametri di controllo fondamentali:
- Abilita l’output personalizzato per questo modello: Attiva globalmente la configurazione corrente su tutti i successivi processi di importazione di quel modello.
- File di output statico: Forza la piattaforma a generare un tracciato record fisso che conterrà sempre tutte le chiavi selezionate, esportandole come colonne vuote nel caso in cui il documento non contenga quel valore (fondamentale per i gestionali ERP rigidi).
- Utilizza un output diverso quando si uniscono i documenti: Se carichi più file insieme o unisci più fogli in un unico flusso, l’abilitazione di questo switch permette di generare un file di output differente, strutturato appositamente per gestire e separare correttamente i dati cumulativi dei documenti uniti senza sovrapporli.
File di output statico
Questa opzione permette di utilizzare il tracciato configurato per tutti i nuovi documenti elaborati con il modello selezionato.
Se viene disattivata, Retica torna a utilizzare la struttura standard, senza eliminare la configurazione personalizzata già salvata.
Utilizza un output diverso quando si uniscono i documenti
Attivando questa opzione puoi creare un secondo tracciato da utilizzare quando più documenti vengono uniti ed esportati in un unico file.
In questo modo puoi organizzare diversamente le informazioni cumulative, senza modificare il tracciato utilizzato per l’esportazione dei singoli documenti.

Strutturazione del file personalizzato
La tabella di configurazione contiene tutte le etichette che il modello può estrarre.
Per ogni etichetta puoi decidere se includerla nel file, rinominarla oppure modificarne la posizione.

Includere o escludere un campo
Utilizza l’interruttore presente sulla riga dell’etichetta:
- se è attivo, il dato viene incluso nel file;
- se è disattivato, il dato non viene esportato.
Questa funzione permette di eliminare dal file tutte le informazioni che non servono al gestionale.
Rinominare una colonna
La colonna Nome etichetta standard mostra il nome utilizzato internamente da Retica.
Se il gestionale richiede un’intestazione differente, inseriscila nel campo Nome etichetta personalizzata.
Ad esempio:
Nome standard: CustomerVatNumber
Nome personalizzato: PARTITA_IVA_CLIENTE
Se il campo personalizzato viene lasciato vuoto, Retica mantiene il nome standard dell’etichetta.
Modificare l’ordine delle colonne
Per cambiare la posizione di un’informazione nel file:
- individua l’icona con le frecce sulla relativa riga;
- tieni premuto;
- trascina la riga nella posizione desiderata;
- rilascia il pulsante.
L’ordine mostrato nella tabella corrisponderà all’ordine delle colonne presenti nel file esportato.
Anteprima del file e salvataggio
Prima di salvare la configurazione, premi Anteprima file.
Retica genera una simulazione del risultato finale, permettendoti di controllare:
- le colonne incluse;
- i nomi personalizzati;
- l’ordine delle informazioni;
- la presenza dei campi vuoti nell’output statico;
- la struttura complessiva richiesta dal gestionale.
L’anteprima serve solamente a verificare il tracciato e non genera un’esportazione definitiva.

Anteprima in Tempo Reale: Cliccando sul comando di verifica (Anteprima File), il sistema genera una simulazione visiva immediata del file finale (in formato tabellare o testuale). Questo ti permette di controllare se l’ordine delle colonne, i nomi personalizzati e i campi statici vuoti rispondono esattamente ai requisiti del tuo gestionale.

Salvataggio della configurazione
Dopo aver verificato l’anteprima, premi Salva in fondo alla pagina.
Le modifiche saranno applicate ai nuovi file generati con il modello selezionato. Se esci dalla pagina senza salvare, le variazioni effettuate non verranno mantenute.
Dopo la prima configurazione è consigliabile elaborare un documento di prova e verificare che il file generato venga importato correttamente dal gestionale.

