Importazione ed esportazione dati¶
DiKAS offre ampie funzioni di importazione ed esportazione: una procedura guidata intelligente per l'importazione degli articoli con supporto opzionale dell'IA, backup e ripristino selettivi con 8 categorie e avanzamento in tempo reale, oltre a un assistente guidato per il passaggio da un altro sistema di cassa.
Admin → Importazione dati
Importazione articoli¶
Panoramica¶
La procedura guidata di importazione conduce attraverso l'importazione degli articoli in 4 passi — dalla selezione del file alla panoramica dei risultati. Le colonne vengono riconosciute automaticamente, opzionalmente con il supporto dell'IA.
Passo 1: Caricare il file¶
Admin → Importazione dati → Importazione articoli
Formati supportati:
| Formato | Descrizione |
|---|---|
| CSV | Separato da punto e virgola o virgola |
| TXT | Separato da tabulazione |
| XLSX | File Excel |
| Tramite estrazione IA (opzionale) | |
| Immagini | JPG/PNG/WebP tramite estrazione IA (ad es. foto di un listino prezzi) |
Trascinare il file nell'area di caricamento oppure fare clic su „Datei auswählen".
Riconoscimento automatico:
DiKAS riconosce automaticamente:
- Carattere separatore: punto e virgola (;), virgola (,), tabulazione, pipe (|)
- Codifica caratteri: UTF-8, Windows-1252 (tramite BOM o euristica)
- Riga di intestazione: se la prima riga contiene le intestazioni delle colonne
Passo 2: Assegnare le colonne¶
DiKAS analizza le intestazioni e i valori delle colonne per proporre la migliore assegnazione:
Riconoscimento automatico delle colonne (16 campi di destinazione):
| Campo DiKAS | Intestazioni di colonna riconosciute |
|---|---|
| Nome | Artikelname, Bezeichnung, Produktname, Product |
| Prezzo | VK-Preis, Preis, Verkaufspreis, Price, Betrag |
| Numero articolo | PLU, SKU, ArtNr, Artikelnr, Number |
| Aliquota fiscale | MwSt, Steuer, Tax, VAT, MwSt% |
| Classe fiscale | Steuerklasse, TaxClass |
| Gruppo merceologico | Gruppe, Warengruppe, Kategorie, Category, WGR |
| Codice a barre | Barcode, EAN, GTIN, EAN13 |
| Unità | Einheit, Mengeneinheit, ME |
| Descrizione | Beschreibung, Langtext, Info |
| Nome breve | Kurzname, Kurz |
| Colore | Farbe, Hintergrund, Background, Color |
| Attivo | Aktiv, Active, Sichtbar, Visible |
| Allergeni | Allergene, Allergen |
| Ordinamento | Sortierung, Position, Reihenfolge |
| Cauzione | Pfand, Deposit |
| Portata | Gang, Course, Küche |
Fasi di riconoscimento: 1. Confronto intestazioni: l'intestazione della colonna viene confrontata con oltre 60 modelli noti 2. Analisi dei valori: in caso di colonne poco chiare vengono analizzate le prime 20 righe (numeri, valori booleani, codici)
Se necessario, correggere l'assegnazione tramite menù a tendina.
Assegnazione tramite IA: se è configurato un fornitore di IA, fare clic su „KI-Vorschlag" — DiKAS invia le intestazioni delle colonne e righe di esempio all'IA e riceve un'assegnazione ottimizzata.
Passo 3: Anteprima e configurazione¶
Verificare i dati importati: - Quanti articoli vengono importati? - Ci sono duplicati? (Stesso numero articolo, codice a barre o nome) - Vengono creati nuovi gruppi?
Gestione dei duplicati:
| Modalità | Descrizione |
|---|---|
| Saltare | Non modificare gli articoli esistenti |
| Aggiornare | Aggiornare gli articoli esistenti con i nuovi dati |
| Sostituire | Eliminare gli articoli esistenti e ricrearli |
Riconoscimento dei duplicati: confronto tramite numero articolo, codice a barre o nome (configurabile).
Trasformazioni dei valori:
| Trasformazione | Descrizione |
|---|---|
| Classe fiscale → Aliquota fiscale | Classe fiscale legacy (0/1/99) → percentuale (19/7/0) |
| Formato prezzo | Formato tedesco (1.000,00) e inglese (1,000.00) |
| Testo booleano | „ja"/„yes"/„1"/„x" → attivo, „nein"/„no"/„0" → inattivo |
| Codici allergeni | Codici legacy (a1–a14) → codici UE (A–N) |
Passo 4: Eseguire l'importazione¶
Fare clic su „Importieren". Il risultato mostra: - Nuovi creati: X articoli - Aggiornati: X articoli - Saltati: X articoli - Errori: X articoli (con dettagli per riga)
I nuovi gruppi merceologici vengono creati automaticamente se il gruppo indicato non esiste ancora.
Profili di importazione¶
Salvare le assegnazioni utilizzate di frequente come profilo:
- Dopo un'assegnazione riuscita: „Salva profilo"
- Inserire un nome (ad es. „Fornitore Müller CSV")
- Vengono salvati: mappatura delle colonne, trasformazioni, carattere separatore, gruppo predefinito, fiscalità, modalità duplicati
- Alla successiva importazione: caricare il profilo → l'assegnazione è già pronta
Impostazioni del profilo¶
| Campo | Descrizione |
|---|---|
| Nome | Nome del profilo |
| Formato di origine | CSV, XLSX, PDF, Image |
| Impostazioni CSV | Carattere separatore, codifica, riga di intestazione, qualificatore di testo |
| Impostazioni Excel | Indice/nome del foglio, riga di intestazione, inizio dei dati |
| Gruppo predefinito | Gruppo merceologico di riserva |
| Aliquota fiscale predefinita | Aliquota fiscale di riserva |
| Modalità duplicati | Saltare / Aggiornare / Sostituire |
| Campo di confronto | Numero articolo / Codice a barre / Nome |
Importazione assistita dall'IA¶
Estrazione da PDF e immagini¶
Per listini prezzi in formato PDF o foto:
- Caricare il PDF o l'immagine (supporta più pagine/più file in un unico passaggio)
- DiKAS invia il file al fornitore di IA configurato
- Per ogni articolo l'IA estrae: nome, prezzo, gruppo, un suggerimento di classe IVA (ordinaria/ridotta/esente), gli allergeni (UE-14, A–N) e — se stampate sul menu — opzioni/extra (ad es. condimenti, formati, contorni) con il relativo supplemento (vedi Opzioni ed extra)
- Invece della mappatura generica delle colonne (passo 2 sopra, valido solo per CSV/XLSX/TXT), il caricamento di foto/PDF apre direttamente il ciclo di correzione — vedi sotto
- Dopo la correzione: proseguire come per l'importazione CSV (passi 3–4, anteprima e importazione)
Ciclo di correzione¶
Il riconoscimento dell'IA è un suggerimento — il ciclo di correzione mostra il risultato come una tabella modificabile prima che venga importato qualcosa:
| Colonna | Modificabile come |
|---|---|
| Nome | Testo libero |
| Prezzo | Testo libero (riconosce i formati tedesco 1.234,56 e inglese 1,234.56) |
| Gruppo | Testo libero con suggerimenti dai gruppi esistenti |
| Classe IVA | Menu a tendina |
| Allergeni | Chip selezionabili dall'elenco allergeni configurato |
- Le righe incerte (confidenza IA < 0,7, prezzo mancante/non valido o nome mancante) sono contrassegnate con un'icona di avviso e un bordo colorato — verificarle prima di importare.
- Le righe possono essere eliminate, e "+ Aggiungi riga" permette di aggiungere manualmente articoli non riconosciuti dall'IA.
- Articoli già esistenti: un interruttore stabilisce se gli articoli con lo stesso nome vengono aggiornati (predefinito — le correzioni dell'utente prevalgono) o lasciati invariati. Il riconoscimento dei duplicati nel percorso foto/PDF si basa sul nome (i menù di solito non hanno un numero articolo).
- Per menù molto grandi (oltre 500 voci riconosciute), il ciclo di correzione mostra/modifica solo le prime 500 — il resto viene importato invariato, con un apposito avviso.
ℹ️ La classe IVA è un suggerimento dell'IA, non un accertamento fiscale vincolante — verificarla prima di importare, in particolare per articoli contrassegnati per asporto/consegna.
Opzioni ed extra¶
Se sul menu sono stampate delle scelte — condimenti, formati, contorni, salse —, l'IA le riconosce e le assegna agli articoli corrispondenti:
- Dopo l'analisi, un avviso «… gruppi di opzioni rilevati» mostra i gruppi trovati (ad es. «Condimenti», «Formato») con il numero delle loro voci.
- Durante l'importazione, i gruppi di opzioni identici vengono uniti tra gli articoli e creati automaticamente come modelli di opzioni; ogni articolo interessato viene collegato al modello corrispondente. Il riepilogo del risultato indica il numero di modelli di opzioni creati.
- Le opzioni si trovano poi in modo centralizzato in Admin → Modelli di opzioni e sul singolo articolo in apri articolo → scheda «Opzioni».
ℹ️ Le opzioni non sono modificabili nel ciclo di correzione (sopra): vengono importate esattamente come le ha riconosciute l'IA. Vengono create come gruppi a selezione multipla con il supplemento stampato; dettagli come selezione singola, selezione obbligatoria, selezione predefinita o «quantità gratis» si impostano successivamente sull'articolo o sul modello di opzioni.
Fornitori di IA supportati¶
| Fornitore | Modello | Descrizione |
|---|---|---|
| OpenAI | GPT-4 Vision | Basato su cloud, richiede una chiave API |
| Anthropic | Claude Vision | Basato su cloud, richiede una chiave API |
| Google Gemini | Gemini 2.0 Flash | Basato su cloud, richiede una chiave API |
| Ollama | Modelli locali | Auto-ospitato, nessuna chiave API necessaria |
Configurazione: Admin → Impostazioni → Importazione IA
Contingente gratuito¶
Senza una propria chiave API sono disponibili 2 importazioni IA gratuite tramite la chiave DiKAS. Per un utilizzo illimitato, inserire la propria chiave API.
Modello Excel¶
Scaricare un modello che contiene tutti i 17 campi di destinazione:
„Vorlage herunterladen" → file Excel con: - Tutte le intestazioni delle colonne - Una riga di esempio con spiegazioni - Indicazioni di formato per ciascuna colonna
Backup e ripristino¶
I suoi dati vengono salvati automaticamente tramite la DiKAS-Cloud — crittografati e conservati al di fuori dell'attività. Non deve creare, scaricare o gestire un backup da sé. Se qualcosa deve essere ripristinato (ad es. dopo la sostituzione di un dispositivo), se ne occupa il supporto DiKAS.
→ Dettagli: Backup & Restore
Passaggio da un altro sistema di cassa¶
Se si passa da un altro sistema di cassa, l'assistente di configurazione accompagna l'utente attraverso l'esportazione, l'importazione e gli obblighi legali legati al cambio — il passaggio ne è una parte.
Avvio: Dashboard Admin → scheda «Assistente di configurazione» → nel passaggio «Da dove provengono i Suoi dati?» scegliere il sistema precedente. In alternativa direttamente tramite Articoli → Importazione (lì è disponibile la modalità «Importazione da un altro sistema di cassa»).
L'assistente è organizzato in passaggi e può essere interrotto in qualsiasi momento — l'ultimo stato salvato viene preselezionato al successivo accesso:
- Scegliere la fonte: ready2order, orderbird, Vectron, un altro sistema (tramite esportazione DSFinV-K) oppure Excel/CSV.
- Guida all'esportazione: una guida passo-passo specifica per il sistema precedente scelto, che indica dove avviare l'esportazione dei dati (comprese le insidie note, ad es. esportazioni inviate via e-mail o un limite di pochi mesi per esportazione con alcuni fornitori).
- Avviare l'importazione: rimanda all'importatore corrispondente (importazione DSFinV-K o ready2order) — per Excel/CSV, all'importazione articoli più in alto in questa pagina.
- Checklist per il passaggio: un elenco spuntabile per un cambio conforme alla normativa — chiusura giornaliera nel vecchio sistema, archiviazione dell'esportazione DSFinV-K finale (10 anni, § 147 AO), conservazione della vecchia TSE, comunicazione della nuova cassa all'Agenzia delle Entrate entro un mese (§ 146a AO, collegata alla configurazione fiscale) e aggiornamento della documentazione procedurale.
⚠️ La checklist è un aiuto e non sostituisce una consulenza fiscale — in caso di dubbio, chiarire scadenze e obblighi con il proprio commercialista o con l'Agenzia delle Entrate.
Domande frequenti¶
Posso importare solo gli articoli senza sovrascrivere il resto? Sì — durante il ripristino selezionare solo la categoria „Articoli". Tutti gli altri dati rimangono invariati.
Cosa succede a un ripristino con scontrini aperti? Gli scontrini aperti appartengono alla categoria „Tavoli". Se non si seleziona questa categoria, gli scontrini aperti attuali rimangono invariati.
L'importazione supporta anche cataloghi di fornitori con oltre 10.000 articoli? Sì — l'importazione elabora anche file di grandi dimensioni. L'elaborazione avviene a lotti con indicatore di avanzamento.
Passo successivo¶
→ Moduli — Moduli aggiuntivi (Disco, Officina, Rilevazione presenze)