# Importazione Dati

EagleMES offre un potente sistema di importazione dati che permette di caricare massivamente informazioni nel sistema utilizzando file Excel o CSV. Questa funzionalità è particolarmente utile durante la fase iniziale di configurazione o per aggiornamenti massivi.

L'importazione dati in EagleMES permette di:

• Caricare anagrafiche (clienti, fornitori, articoli)
• Importare transazioni (ordini, movimenti di magazzino)
• Aggiornare dati esistenti in modo massivo
• Risparmiare tempo evitando inserimenti manuali ripetitivi

1. Clicca sull'icona Cerca (🔍) nella barra superiore
2. Digita "Data Import" o "Importazione Dati"
3. Seleziona Data Import dai risultati

1. Naviga alla lista del tipo di documento che vuoi importare (es. Articoli, Clienti)
2. Clicca sul pulsante Menu (tre puntini) in alto a destra
3. Seleziona Importa

1. Apri Data Import
2. Clicca su Nuovo (New)
3. Compila i campi iniziali:
   • Import Type: Seleziona il tipo di documento (es. Item, Customer, Supplier)
   • Import Name: Nome descrittivo per identificare l'importazione

1. Nella sezione Download Template, clicca su Download Template
2. Scegli il formato:
   • Excel (consigliato per la compatibilità)
   • CSV (per file più leggeri)

1. Apri il file template scaricato con Excel o LibreOffice
2. Prima riga: Contiene i nomi tecnici dei campi (non modificare)
3. Dalla seconda riga in poi: Inserisci i tuoi dati

• Campi obbligatori: Contrassegnati con * nell'intestazione
• Formati data: Usa il formato YYYY-MM-DD (es. 2025-11-11)
• Valori Si/No: Usa 1 per Sì, 0 per No
• Campi collegati: Inserisci il nome esatto come appare nel sistema
• Valute/Numeri: Usa il punto . come separatore decimale

1. Torna alla scheda Data Import in EagleMES
2. Nella sezione Upload File, clicca su Allega
3. Seleziona il file compilato dal tuo computer
4. Clicca Carica

Dopo il caricamento, il sistema mostra l'anteprima dei dati:

1. Verifica la mappatura automatica delle colonne
2. Se necessario, ricollega manualmente le colonne ai campi corretti
3. Controlla l'anteprima dei dati nella tabella

Prima di avviare l'importazione, configura le opzioni:

1. Clicca sul pulsante Start Import
2. Il sistema elabora i dati in background
3. Puoi monitorare il progresso nella barra di stato

Dopo il completamento:

1. Controlla il riepilogo dell'importazione:

   • Record importati con successo
   • Record con errori
   • Dettagli degli errori

2. Se ci sono errori:

   • Scarica il Error Log (registro errori)
   • Correggi i dati nel file
   • Riprova l'importazione

Campi principali:

• item_code - Codice articolo (univoco)
• item_name - Nome articolo
• item_group - Gruppo merceologico
• stock_uom - Unità di misura
• is_stock_item - Articolo di magazzino (1/0)
• valuation_rate - Valore unitario

Esempio pratico:

Importare 500 articoli da catalogo fornitore in Excel

Campi principali:

• customer_name - Nome cliente
• customer_type - Tipo (Company/Individual)
• customer_group - Gruppo cliente
• territory - Territorio/Area
• email_id - Email
• mobile_no - Telefono

Campi principali:

• supplier_name - Nome fornitore
• supplier_group - Gruppo fornitore
• supplier_type - Tipo fornitore
• email_id - Email
• mobile_no - Telefono

Particolarità:

• Richiede importazione separata per intestazione e righe
• Prima importare i BOM (header)
• Poi importare i BOM Items (componenti)

Alcuni documenti hanno tabelle figlie (es. Righe Ordine). Per importarle:

1. Importa prima il documento principale (Parent)
2. Poi importa la tabella figlia collegandola al parent

Utilizza la notazione con tilde ~ per campi ripetuti:

item_code | items~item_code | items~qty | items~rate
PROD-001  | COMP-A          | 5         | 10.00
PROD-001  | COMP-B          | 3         | 15.00

1. Pulisci i dati: Rimuovi spazi extra, caratteri speciali
2. Verifica univocità: Assicurati che i codici siano univoci
3. Completa i riferimenti: Verifica che i collegamenti (es. Customer Group) esistano già nel sistema
4. Backup: Fai sempre un backup prima di importazioni massive

• Inizia con dati di base: Prima anagrafiche (gruppi, categorie), poi transazioni
• Procedi per blocchi: Importa 100-500 record alla volta per grandi dataset
• Monitora gli errori: Controlla subito gli errori e correggili

Per importazioni automatizzate, usa l'API REST di ERPNext:

import requests

url = "https://tuoserver.com/api/method/frappe.core.doctype.data_import.data_import.import_file"
headers = {
    "Authorization": "token API_KEY:API_SECRET"
}
files = {
    "file": open("dati.xlsx", "rb")
}
data = {
    "doctype": "Item",
    "import_type": "Insert"
}

response = requests.post(url, headers=headers, files=files, data=data)

Utilizza il Data Import Tool con scheduled jobs per importazioni ricorrenti.

• Dimensione file: Massimo 25 MB per upload
• Righe per importazione: Raccomandato max 10.000 righe
• Timeout: Importazioni molto lunghe potrebbero andare in timeout

1. Suddividi il file in più importazioni
2. Usa l'API per importazioni programmatiche
3. Ottimizza il server (aumenta timeout, memoria)

Alcune versioni di ERPNext includono anche il vecchio strumento:

• Setup → Data Import Tool
• Meno flessibile ma più semplice per importazioni basiche

Per casi complessi, sviluppa script Python personalizzati usando l'ORM di Frappe.

Prima di ogni importazione, verifica:

• Ho scaricato il template corretto per il DocType?
• Tutti i campi obbligatori sono compilati?
• I formati data/numero sono corretti?
• I riferimenti esterni (link) esistono già nel sistema?
• Ho fatto un test con pochi record?
• Ho un backup recente del sistema?
• Ho scelto la modalità corretta (Insert/Update)?

Possibili cause:

• File troppo grande (>25 MB)
• Formato non supportato
• Colonne del template modificate

Soluzione:

• Riduci dimensione file
• Usa formato Excel (.xlsx) o CSV
• Riscarica template originale

Possibili cause:

• Dati non conformi ai requisiti del campo
• Campi obbligatori mancanti
• Formati errati

Soluzione:

• Leggi attentamente il messaggio di errore
• Correggi i dati nel file sorgente
• Controlla il Data Type di ogni campo

Possibili cause:

• Troppe righe
• Server con risorse limitate
• Validazioni complesse

Soluzione:

• Suddividi in importazioni più piccole
• Esegui durante orari di basso utilizzo
• Ottimizza configurazione server

Dopo aver importato i dati base, esplora:

• Gestione Articoli - Configurazione dettagliata articoli
• Distinte Base - Creazione strutture prodotto
• Configurazione - Impostazioni sistema