CheckappExcel — Confronta listini Excel/CSV per codice prodotto

Applicazione Python per confrontare due o più file Excel/CSV di listini prodotti — anche con più fogli ciascuno — e produrre un unico file Excel con colonne colorate per file, evidenziando prodotti presenti/mancanti, differenze di prezzo, trasporto e installazione.

La chiave primaria del confronto è sempre il codice prodotto.

👉 Usa l'app online

Carica i file direttamente nel browser e scarica l'Excel confrontato. Tutto avviene lato client: nessun file viene caricato su server.

Se invece preferisci la versione desktop / da integrare in script, leggi le sezioni qui sotto.

• Supporta .xlsx, .xlsm, .xls, .csv, .tsv (separatori , e ; rilevati automaticamente).
• Accetta N file come input (non solo due).
• Gestisce file con più fogli: può unirli in un'unica tabella o tenerli distinti.
• Riconosce automaticamente i nomi delle colonne (italiano e inglese):
  • codice: Codice, cod., SKU, ID, Item Code...
  • descrizione: Descrizione, Desc, Nome, Description...
  • prezzo: Prezzo, Prezzo netto, Prezzo listino, Price...
  • trasporto: Trasporto, Spese trasporto, Spedizione, Shipping...
  • installazione: Installazione, Montaggio, Installation, Setup...
• Codici normalizzati: trim, gestione .0 dei numerici, case-insensitive (configurabile).
• Output Excel con:
  • un blocco di colonne per ciascun file, con colore di intestazione dedicato;
  • celle gialle per i prodotti assenti in quel file;
  • celle verdi per i prodotti presenti solo in un file;
  • celle arancio sul prezzo quando i valori differiscono fra file;
  • foglio Riepilogo con legenda e statistiche;
  • foglio Mancanti con solo i codici non presenti ovunque.
• Doppia interfaccia: CLI + GUI Tkinter.

Richiede Python 3.9+.

git clone https://github.com/pezzaliapp/CheckappExcel.git
cd CheckappExcel
pip install -r requirements.txt

python -m checkapp fornitore_a.xlsx fornitore_b.xlsx -o confronto.xlsx

Con più file e CSV:

python -m checkapp listino_A.xlsx listino_B.xlsx listino_C.csv \
 -o risultato.xlsx \
 --labels "Fornitore A" "Fornitore B" "Fornitore C"

Opzioni:

python gui.py

GUI

Dalla GUI puoi:

1. Aggiungere più file.
2. Rinominare l'etichetta che comparirà nel report.
3. Scegliere dove salvare l'output.
4. Avviare il confronto e aprire direttamente la cartella di destinazione.

from checkapp import run_comparison, CompareOptions
result = run_comparison(
 ["listino_A.xlsx", "listino_B.xlsx"],
 output_path="out.xlsx",
 labels=["Fornitore A", "Fornitore B"],
 options=CompareOptions(merge_sheets=True, case_sensitive_codes=False),
)
print(result["stats"])

Il file di output contiene 3 fogli:

Conteggio totale dei codici, quanti sono in tutti i file, quanti parzialmente, quanti unici a un file, più la legenda dei colori.

Una riga per ogni codice distinto trovato nell'unione dei file, e blocchi di 4 colonne per ciascun file:

Codice | Stato | [Fornitore A: Desc | Prezzo | Trasp | Install] | [Fornitore B: ...] | ...

• L'intestazione di ciascun blocco è colorata in modo univoco (blu, verde, arancio, viola, ...).
• Le celle gialle segnalano che il prodotto non è presente in quel file.
• Le celle verdi segnalano che il prodotto è presente solo in quel file.
• Le celle arancio sulla colonna Prezzo segnalano che i prezzi differiscono tra i file.
• I prezzi sono formattati come valuta (€).
• Filtri automatici e freeze panes già configurati.

Solo i codici che non sono presenti in tutti i file, con una matrice Sì/No per file.

La cartella examples/ contiene tre file di prova:

• fornitore_A.xlsx — listino semplice (1 foglio).
• fornitore_B.xlsx — 2 fogli (Listino + Promozioni), intestazioni diverse.
• fornitore_C.csv — CSV con separatore ; e colonne in inglese.

Prova:

python examples/_generate_examples.py # (ri)genera i file di esempio
python -m checkapp examples/fornitore_A.xlsx examples/fornitore_B.xlsx \
 examples/fornitore_C.csv -o examples/confronto_esempio.xlsx

Se i tuoi listini usano nomi colonna particolari, puoi estendere la mappa degli alias passando un CompareOptions personalizzato:

from checkapp import CompareOptions, run_comparison
opts = CompareOptions(output_path="out.xlsx")
opts.column_aliases["codice"].append("matricola")
opts.column_aliases["prezzo"].append("imponibile")
run_comparison(["a.xlsx", "b.xlsx"], output_path="out.xlsx", options=opts)

# test
python -m unittest discover -s tests -v

Struttura del progetto:

CheckappExcel/
├── checkapp/
│ ├── __init__.py
│ ├── __main__.py # permette `python -m checkapp`
│ ├── comparator.py # logica di confronto ed export
│ ├── cli.py # interfaccia a riga di comando
│ └── gui.py # interfaccia Tkinter
├── examples/ # file di prova
├── tests/ # unit test
├── gui.py # shortcut per lanciare la GUI
├── requirements.txt
├── LICENSE
└── README.md

MIT — vedi LICENSE.

Alessandro Pezzali — github.com/pezzaliapp · alessandropezzali.it

Se CheckappExcel ti è stato utile, lascia una ⭐ sul repo: aiuta a farlo trovare ad altri.