Update src/streamlit_app.py

src/streamlit_app.py

@@ -4,6 +4,96 @@ import os
 import streamlit as st
 import numpy as np # Importa numpy per np.nan
 
+# --- Dati di Configurazione del Tracciato ---
+# Dizionario per i valori di default/fissi per i campi specifici del .dat
+# Basato sull'ultimo tracciato fornito nell'immagine.
+fixed_and_default_values = {
+    # Campi fissi Mittente (Campi 1-18) - Valori dalla tabella utente
+    'codice_identificativo_cliente': 'CLI 000000009', # Campo 1
+    'id_ldv': 'FIL01',                        # Campo 2
+    'tipo_spedizione': 'N',                   # Campo 3
+    'attivazione_ritiro': 'N',                      # Campo 4
+    'stampa_ldv': 'N',                              # Campo 5
+    # Campo 6 (Numero Riferimento Spedizione) dal file shippingMark
+    # Campo 7 (Data Spedizione) dal file shipmentOrder.orderDate
+    'ritiro_mp': 'P',                         # Campo 8
+    'codice_indirizzo_mittente': 'IND001',    # Campo 9
+    'ragione_sociale_mittente': 'Poste Logistics + Technolt', # Campo 10
+    'contatto_mittente': 'postelogistics@poste.it', # Campo 11
+    'tipo_via_mittente': 'Viale',               # Campo 12
+    'via_mittente': 'delle Industrie',        # Campo 13
+    'numero_civico_mittente': '9-11-13',           # Campo 14
+    'numero_telefono_mittente': '60898001',   # Campo 15
+    'cap_mittente': '27018',                  # Campo 16
+    'localita_mittente': 'Vidigulfo',         # Campo 17
+    'provincia_mittente': 'PV',               # Campo 18
+
+    # Altri campi fissi o con default obbligatorio
+    'codice_servizio': 'EXT',                    # Campo 34
+    'filiale': 'MD',                   # Campo 43
+    'tipo_cliente': 'MGCS',                    # Campo 49
+}
+
+# Definizione dettagliata del layout del file .dat.
+# INCLUDE SOLO I CAMPI DALL'ULTIMO TRACCIATO FORNITO DALL'UTENTE.
+# 'name': Nome interno per il campo nel codice.
+# 'length': Lunghezza fissa del campo.
+# 'numeric_pad_zero': True se il campo è numerico e va riempito con '0' a sinistra.
+# 'decimals': Numero di decimali (per campi numerici di valuta, non usati nel nuovo tracciato).
+# 'mandatory': True se il campo è obbligatorio (*) o (**) nel tracciato.
+# 'source': Indica la fonte del valore: 'fixed' (da fixed_and_default_values),
+#           'shipping_mark_file' (dal DataFrame shippingMark),
+#           'shipment_order_file' (dal DataFrame shipmentOrder),
+#           'derived' (calcolato, es. data corrente o campi concatenati),
+#           'filler' (gap nel tracciato).
+# 'excel_col': Il nome esatto della colonna nel file Excel di origine (se 'source' è 'shipping_mark_file' o 'shipment_order_file').
+# 'description': Descrizione del campo (per il file di specifiche).
+# 'start_pos': Posizione iniziale del campo (per il file di specifiche).
+dat_format_spec = [
+    # Id | Nome                        | Obbl | Tipo  | Lungh | Inizio | Descrizione                                                               | Default             | Campi
+    {'id': '1', 'name': 'codice_identificativo_cliente', 'length': 12, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Valore costante che identifica il cliente, viene comunicato al cliente al momento dell'attivazione del servizio, un esempio di codice è CLI 000000009", 'start_pos': 1},
+    {'id': '2', 'name': 'id_ldv',                      'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Fillare con la numerazione della ldv", 'start_pos': 13},
+    {'id': '3', 'name': 'tipo_spedizione',             'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Indica il tipo di spedizione N Porto Franco P porto assegnato T triangolazione", 'start_pos': 43},
+    {'id': '4', 'name': 'attivazione_ritiro',          'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Indica se deve essere attivato il ritiro. In assenza di accordi con Poste impostare il valore costante N", 'start_pos': 44},
+    {'id': '5', 'name': 'stampa_ldv',                  'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Mettere N", 'start_pos': 45},
+    {'id': '6', 'name': 'numero_riferimento_spedizione', 'length': 25, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipping_mark_file', 'excel_col': 'orderref', 'description': "Numero Rif. Ord. Cliente, è il riferimento della spedizione per il cliente", 'start_pos': 46},
+    {'id': '7', 'name': 'data_spedizione',             'length': 8,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'orderdate', 'description': "Data della spedizione in formato AAAAMMGG (Mese, Giorno)", 'start_pos': 71},
+    {'id': '8', 'name': 'ritiro_mp',                   'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Indica il tipo di ritiro. In assenza di accordi con Poste impostare il valore costante P", 'start_pos': 79},
+    {'id': '9', 'name': 'codice_indirizzo_mittente',   'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Identifica la codifica dell'indirizzo di ritiro del mittente", 'start_pos': 80},
+    {'id': '10', 'name': 'ragione_sociale_mittente',    'length': 40, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 100},
+    {'id': '11', 'name': 'contatto_mittente',           'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 140},
+    {'id': '12', 'name': 'tipo_via_mittente',           'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 160},
+    {'id': '13', 'name': 'via_mittente',                'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 165},
+    {'id': '14', 'name': 'numero_civico_mittente',      'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 195},
+    {'id': '15', 'name': 'numero_telefono_mittente',    'length': 15, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 200},
+    {'id': '16', 'name': 'cap_mittente',                'length': 9,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 215},
+    {'id': '17', 'name': 'localita_mittente',           'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 224},
+    {'id': '18', 'name': 'provincia_mittente',          'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Ignorato se è valorizzato il campo 9", 'start_pos': 254},
+    
+    # Filler per il gap tra Campo 18 (fine a 255) e Campo 20 (inizio a 315)
+    {'id': '', 'name': 'filler_gap_18_20',             'length': 60, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': False, 'source': 'filler', 'excel_col': None, 'description': "Gap tra i campi 18 e 20", 'start_pos': 256}, # 315 - 255 = 60
+
+    # Campi Destinatario e Colli
+    {'id': '20', 'name': 'ragione_sociale_destinatario', 'length': 40, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.businessname', 'description': "Ragione sociale del destinatario", 'start_pos': 315},
+    {'id': '21', 'name': 'contatto_destinatario',       'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.name', 'description': "Nome Contatto presso il Destinatario", 'start_pos': 355},
+    {'id': '22', 'name': 'tipo_via_destinatario',       'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.streettype', 'description': "Descrizione tipo via", 'start_pos': 375},
+    {'id': '23', 'name': 'via_destinatario',            'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.address', 'description': "Indirizzo del destinatario", 'start_pos': 380},
+    {'id': '24', 'name': 'numero_civico_destinatario',  'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.addressnumber', 'description': "Numero Civico Destinatario allineato a sinistra", 'start_pos': 410},
+    {'id': '25', 'name': 'numero_telefono_destinatario','length': 15, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.phone.number', 'description': "Numero di telefono Destinatario", 'start_pos': 415},
+    {'id': '26', 'name': 'cap_destinatario',            'length': 9,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.zipcode', 'description': "CAP del destinatario allineato a sinistra", 'start_pos': 430},
+    {'id': '27', 'name': 'localita_destinatario',       'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.city', 'description': "Località del destinatario", 'start_pos': 439},
+    {'id': '28', 'name': 'provincia_destinatario',      'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipment_order_file', 'excel_col': 'consegnee.partner.address.country', 'description': "Provincia del destinatario", 'start_pos': 469}, # Assumo 'country' è provincia 2 char
+    {'id': '29', 'name': 'numero_colli',                'length': 3,  'numeric_pad_zero': True, 'decimals': 0, 'mandatory': True, 'source': 'shipping_mark_file', 'excel_col': 'totalvolume', 'description': "Numero dei colli totali che compongono la spedizione", 'start_pos': 471},
+    {'id': '30', 'name': 'peso_colli',                  'length': 7,  'numeric_pad_zero': True, 'decimals': 0, 'mandatory': True, 'source': 'shipping_mark_file', 'excel_col': 'totalweight', 'description': "Peso espresso in grammi del singolo collo", 'start_pos': 474},
+    
+    # Altri Campi Obbligatori dal tracciato
+    {'id': '34', 'name': 'codice_servizio',             'length': 3,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Vedi codifica", 'start_pos': 481},
+    {'id': '42', 'name': 'identificativo_collo',        'length': 25, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'shipping_mark_file', 'excel_col': 'shippingmark', 'description': "Identificativo del singolo collo (barcode)", 'start_pos': 484},
+    {'id': '43', 'name': 'filiale',                     'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Codice Filiale per il ritiro (Comunicato da Poste)", 'start_pos': 509},
+    {'id': '49', 'name': 'tipo_cliente',                'length': 4,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True, 'source': 'fixed', 'excel_col': None, 'description': "Valore costante: MGCS", 'start_pos': 511},
+]
+
+# --- Funzione per generare il file DAT e DIS ---
 def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
     """
     Genera un file .dat per Poste Italiane unendo i dati da due DataFrame.
@@ -23,45 +113,38 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
         df_shipment_order = df_shipment_order_input.copy()
 
         # Assicurati che i nomi delle colonne siano in minuscolo per una maggiore robustezza
+        # Nota: per nomi con punti come 'consegnee.partner.address.address', .lower() li mantiene così.
         df_shipping_mark.columns = df_shipping_mark.columns.str.lower()
         df_shipment_order.columns = df_shipment_order.columns.str.lower()
 
         # Verifica la presenza delle colonne necessarie nel file shipping mark
-        # Ora include totalweight e totalvolume
         required_shipping_mark_cols = ['shippingmark', 'orderref', 'totalweight', 'totalvolume']
         if not all(col in df_shipping_mark.columns for col in required_shipping_mark_cols):
-            st.error(f"Il file delle shipping mark deve contenere le colonne: {required_shipping_mark_cols}")
+            st.error(f"Errore: Il file delle shipping mark deve contenere le colonne: {required_shipping_mark_cols}")
             return None, None
 
-        # Mapping dei nomi delle colonne dal file ShipmentOrder_ ai nomi interni/standardizzati.
-        # **IMPORTANTE**: Le chiavi di questo dizionario devono corrispondere esattamente
-        # ai nomi delle colonne (in minuscolo) presenti nel tuo file ShipmentOrder_.xlsx.
-        # Se le tue colonne sono "consegnee.partner.address.address", DEVONO ESSERE ESATTAMENTE COSÌ.
-        # Se sono flat come "consignee_address", devi modificare queste chiavi.
-        column_mapping = {
-            # Campi destinatario e data che si aspettano dal file ShipmentOrder_.
+        # Applica il mapping delle colonne a df_shipment_order.
+        # Le chiavi del mapping DEVONO corrispondere esattamente ai nomi delle colonne (in minuscolo)
+        # nel tuo file Excel.
+        # Esempio: se la colonna in Excel è "consegnee.partner.businessName", la chiave qui deve essere "consegnee.partner.businessname".
+        excel_col_mapping = {
             'orderdate': 'order_date', # Per Campo 7
             'consegnee.partner.businessname': 'ragione_sociale_destinatario', # Campo 20
-            'consegnee.partner.contact.name': 'consignee_contact', # Campo 21
-            'consegnee.partner.address.streettype': 'consignee_street_type', # Campo 22
-            'consegnee.partner.address.address': 'consignee_address', # Campo 23
-            'consegnee.partner.address.addressnumber': 'consignee_house_number', # Campo 24
-            'consegnee.partner.phone.number': 'consignee_phone', # Campo 25
-            'consegnee.partner.address.zipcode': 'consignee_zip_code', # Campo 26
-            'consegnee.partner.address.city': 'consignee_city', # Campo 27
-            'consegnee.partner.address.province': 'consignee_province', # Campo 28 (assumendo che esista questa colonna per la provincia)
-            # Nota: 'consegnee.partner.address.country' non è nel tracciato .dat fornito.
+            'consegnee.partner.name': 'contatto_destinatario', # Campo 21
+            'consegnee.partner.address.streettype': 'tipo_via_destinatario', # Campo 22
+            'consegnee.partner.address.address': 'via_destinatario', # Campo 23
+            'consegnee.partner.address.addressnumber': 'numero_civico_destinatario', # Campo 24
+            'consegnee.partner.phone.number': 'numero_telefono_destinatario', # Campo 25
+            'consegnee.partner.address.zipcode': 'cap_destinatario', # Campo 26
+            'consegnee.partner.address.city': 'localita_destinatario', # Campo 27
+            'consegnee.partner.address.country': 'provincia_destinatario', # Campo 28 (assunto essere codice provincia 2 char)
         }
-
-        # Applica il mapping delle colonne a df_shipment_order.
-        # La funzione lambda `x` viene applicata ai nomi delle colonne attuali (già in minuscolo)
-        # e poi cerca nel `column_mapping`.
-        df_shipment_order = df_shipment_order.rename(columns=lambda x: column_mapping.get(x, x))
+        df_shipment_order = df_shipment_order.rename(columns=lambda x: excel_col_mapping.get(x, x))
 
         # Assicurati che 'orderref' e 'order_date' siano presenti in df_shipment_order dopo il rename
         required_shipment_order_cols = ['orderref', 'order_date']
         if not all(col in df_shipment_order.columns for col in required_shipment_order_cols):
-            st.error(f"Il file degli ordini deve contenere le colonne: {required_shipment_order_cols} (anche dopo il mapping).")
+            st.error(f"Errore: Il file degli ordini deve contenere le colonne: {required_shipment_order_cols} (anche dopo il mapping).")
             return None, None
 
         # Pulisci le colonne di join per una corrispondenza robusta (rimuovi spazi e assicurati che siano stringhe)
@@ -78,82 +161,6 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
             st.warning("Nessun record corrispondente trovato dopo la join. Assicurati che 'orderRef' sia presente e corrisponda in entrambi i file.")
             return None, None
 
-        # Dizionario per i valori di default/fissi per i campi obbligatori o predeterminati
-        # Basato sul NUOVO tracciato fornito.
-        fixed_and_default_values = {
-            # Campi fissi Mittente (Campi 1-18) - Valori dalla tua ultima tabella
-            'codice_identificativo_cliente_fixed': 'CLI000000009', # Campo 1
-            'id_ldv_fixed': 'FIL01',                        # Campo 2
-            'tipo_spedizione_fixed': 'N',                   # Campo 3
-            'attivazione_ritiro_fixed': 'N',                      # Campo 4
-            'stampa_ldv_fixed': 'N',                              # Campo 5
-            # Campo 6 (orderref) dal file
-            # Campo 7 (data_spedizione_derived) è derivato da order_date dal file
-            'ritiro_mp_fixed': 'P',                         # Campo 8
-            'codice_indirizzo_mittente_fixed': 'IND001',    # Campo 9
-            'ragione_sociale_mittente_fixed': 'Poste Logistics', # Campo 10
-            'contatto_mittente_fixed': 'postelogistics@poste.it', # Campo 11
-            'tipo_via_mittente_fixed': 'Via',               # Campo 12
-            'via_mittente_fixed': 'Via da Inserire',        # Campo 13
-            'numero_civico_mittente_fixed': '54',           # Campo 14
-            'numero_telefono_mittente_fixed': '60898001',   # Campo 15
-            'cap_mittente_fixed': '70019',                  # Campo 16
-            'localita_mittente_fixed': 'Vidigulfo',         # Campo 17
-            'provincia_mittente_fixed': 'PV',               # Campo 18
-
-            # Altri campi fissi o con default obbligatorio dal NUOVO tracciato
-            'service_code_fixed': 'STD',                    # Campo 34
-            'branch_code_fixed': 'FIL05',                   # Campo 43
-            'client_type_fixed': 'MGCS',                    # Campo 49
-        }
-
-        # Definizione dettagliata del layout del file .dat.
-        # INCLUDE SOLO I CAMPI DALL'ULTIMO TRACCIATO FORNITO DALL'UTENTE.
-        # 'source_type': 'fixed' (valore dal dizionario fixed_and_default_values),
-        #                'file' (valore dal DataFrame unito df_merged),
-        #                'derived' (calcolato, es. data_spedizione_derived)
-        dat_format_spec = [
-            # BLOCCO MITTENTE FISSO (Campi 1-18 dal NUOVO tracciato)
-            {'name': 'codice_identificativo_cliente_fixed', 'length': 12, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 1
-            {'name': 'id_ldv_fixed',                'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 2
-            {'name': 'tipo_spedizione_fixed',       'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 3
-            {'name': 'attivazione_ritiro_fixed',          'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 4
-            {'name': 'stampa_ldv_fixed',                  'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 5
-            {'name': 'orderref',                    'length': 25, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 6 (Numero Riferimento Spedizione - dal file shipping mark)
-            {'name': 'order_date',                  'length': 8,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 7 (Data della spedizione - da orderDate dal file shipmentOrder)
-            {'name': 'ritiro_mp_fixed',             'length': 1,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 8
-            {'name': 'codice_indirizzo_mittente_fixed', 'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 9
-            {'name': 'ragione_sociale_mittente_fixed',  'length': 40, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 10
-            {'name': 'contatto_mittente_fixed',     'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 11
-            {'name': 'tipo_via_mittente_fixed',     'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 12
-            {'name': 'via_mittente_fixed',          'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 13
-            {'name': 'numero_civico_mittente_fixed','length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 14
-            {'name': 'numero_telefono_mittente_fixed', 'length': 15, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 15
-            {'name': 'cap_mittente_fixed',          'length': 9,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 16
-            {'name': 'localita_mittente_fixed',     'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 17
-            {'name': 'provincia_mittente_fixed',    'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 18
-            {'name': 'filler_19_gap',               'length': 60, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': False}, # Gap tra 18 e 20
-
-            # Campi 20-30 (Destinatario e Colli)
-            {'name': 'ragione_sociale_destinatario','length': 40, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 20 (da file shipmentOrder)
-            {'name': 'consignee_contact',           'length': 20, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 21 (da file shipmentOrder)
-            {'name': 'consignee_street_type',       'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 22 (da file shipmentOrder)
-            {'name': 'consignee_address',           'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 23 (da file shipmentOrder)
-            {'name': 'consignee_house_number',      'length': 5,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 24 (da file shipmentOrder)
-            {'name': 'consignee_phone',             'length': 15, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 25 (da file shipmentOrder)
-            {'name': 'consignee_zip_code',          'length': 9,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 26 (da file shipmentOrder)
-            {'name': 'consignee_city',              'length': 30, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 27 (da file shipmentOrder)
-            {'name': 'consignee_province',          'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 28 (da file shipmentOrder)
-            {'name': 'totalvolume',                 'length': 3,  'numeric_pad_zero': True, 'decimals': 0, 'mandatory': True}, # 29 (Numero colli - da totalVolume da shippingMark)
-            {'name': 'totalweight',                 'length': 7,  'numeric_pad_zero': True, 'decimals': 0, 'mandatory': True}, # 30 (Peso colli - da totalWeight da shippingMark)
-
-            # Campi 34, 42, 43, 49 (Servizio, Identificativo, Filiale, Tipo Cliente)
-            {'name': 'service_code_fixed',          'length': 3,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 34 (STD)
-            {'name': 'shippingmark',                'length': 25, 'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 42 (Identificativo collo - shippingMark)
-            {'name': 'branch_code_fixed',           'length': 2,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 43 (FIL05)
-            {'name': 'client_type_fixed',           'length': 4,  'numeric_pad_zero': False, 'decimals': 0, 'mandatory': True}, # 49 (MGCS)
-        ]
-
         # Genera il contenuto del file .dat
         dat_content = []
         for index, row in df_merged.iterrows():
@@ -162,62 +169,63 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
             for field_spec in dat_format_spec:
                 field_name = field_spec['name']
                 length = field_spec['length']
-                is_numeric_zero_padded = field_spec['numeric_pad_zero']
-                dec_places = field_spec['decimals']
-                is_mandatory = field_spec['mandatory']
+                is_numeric_pad_zero = field_spec['numeric_pad_zero']
+                decimals = field_spec['decimals']
+                mandatory = field_spec['mandatory']
+                source_type = field_spec['source']
+                excel_col_name = field_spec['excel_col'] # Nome della colonna in Excel (mappata)
                 
                 value_to_format = ''
 
-                if field_name.endswith('_fixed'): # Campi fissi
+                if source_type == 'fixed':
                     value_to_format = fixed_and_default_values.get(field_name, '')
-                elif field_name.endswith('_derived'): # Campi derivati (es. data)
-                    if field_name == 'order_date': # Correzione: order_date è da 'file'
-                        value_to_format = row.get(field_name, '')
+                elif source_type == 'shipping_mark_file':
+                    value_to_format = row.get(excel_col_name)
+                    if pd.isna(value_to_format):
+                        value_to_format = ''
+                elif source_type == 'shipment_order_file':
+                    value_to_format = row.get(excel_col_name)
+                    if pd.isna(value_to_format):
+                        value_to_format = ''
+                    # Gestione specifica per 'order_date' (Campo 7) per formattazione AAAAMMGG
+                    if field_name == 'data_spedizione':
                         if pd.notna(value_to_format):
-                            # Tenta di convertire la data nel formato AAAAMMGG
                             try:
-                                # Se è già una stringa e ha la lunghezza giusta, usala
-                                if isinstance(value_to_format, str) and len(value_to_format) == 8 and value_to_format.isdigit():
+                                if isinstance(value_to_format, datetime): # Se è già un oggetto datetime
+                                    value_to_format = value_to_format.strftime("%Y%m%d")
+                                elif isinstance(value_to_format, str) and len(value_to_format) == 8 and value_to_format.isdigit():
+                                    # Se è già una stringa nel formato giusto, usala così com'è
                                     pass
-                                else: # Altrimenti, prova a convertirla da un formato data pandas
+                                else: # Prova a convertirla
                                     value_to_format = pd.to_datetime(value_to_format).strftime("%Y%m%d")
                             except Exception:
                                 value_to_format = '' # Fallback se la conversione fallisce
                         else:
                             value_to_format = '' # Se NaN, usa vuoto
-
-                    elif field_name == 'data_spedizione_derived': # Data corrente per il campo 7, se non da file
-                        value_to_format = datetime.now().strftime("%Y%m%d")
-                    else:
-                        value_to_format = '' # Fallback per altri derivati
-                elif field_name == 'filler_19_gap':
-                    value_to_format = ' ' * length
-                else: # Campi da prendere direttamente dal DataFrame unito (file)
-                    value_to_format = row.get(field_name)
-                    # Gestisci NaN dopo la merge, se il campo dal file non è presente per quel record
-                    if pd.isna(value_to_format):
-                        value_to_format = ''
+                elif source_type == 'filler':
+                    value_to_format = ' ' * length # Riempie il filler con spazi
                 
                 # Conversione in stringa e pulizia iniziale
                 value_str = str(value_to_format).strip()
 
-                # Se il campo è obbligatorio e il valore è ancora vuoto dopo aver cercato, usa il default
-                if is_mandatory and not value_str:
-                    if is_numeric_zero_padded:
+                # Gestione specifica per Campo 25 (Numero di telefono Destinatario) "se vuoto mettere tanti zeri"
+                if field_name == 'numero_telefono_destinatario' and mandatory and not value_str:
+                    value_str = '0' * length
+                # Se il campo è obbligatorio e il valore è ancora vuoto dopo aver cercato/gestito casi speciali, usa il default (spazi o zeri)
+                elif mandatory and not value_str:
+                    if is_numeric_pad_zero:
                         value_str = '0' * length
                     else:
-                        value_str = ' ' * length # Riempie con spazi se stringa obbligatoria vuota
+                        value_str = ' ' * length 
 
                 # Formattazione finale (allineamento, padding)
-                if is_numeric_zero_padded:
+                if is_numeric_pad_zero:
                     try:
                         clean_value = value_str.replace(',', '.') # Sostituisce virgole con punti
-                        
-                        if dec_places > 0:
-                            num_value = float(clean_value) * (10**dec_places)
-                            formatted_value = str(int(round(num_value))).rjust(length, '0')
-                        else:
-                            formatted_value = str(int(float(clean_value))).rjust(length, '0')
+                        # Converti in int dopo aver gestito i decimali (se presenti, altrimenti 0)
+                        # Nota: nel nuovo tracciato non ci sono campi con 'decimals' > 0, ma la logica è robusta.
+                        num_val = float(clean_value) * (10**decimals)
+                        formatted_value = str(int(round(num_val))).rjust(length, '0')
                     except ValueError:
                         formatted_value = '0'.rjust(length, '0') # Fallback se la conversione fallisce
                 else:
@@ -228,11 +236,12 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
             
             dat_content.append("".join(record_parts))
 
-        # Genera il nome del file con timestamp
+        # Genera il nome del file con timestamp (uguale per .dat e .dis)
         now = datetime.now()
         filename_timestamp = now.strftime("%Y%m%d%H%M%S%f")[:-4] # AAAAMMGGhhmmsscc
-        dat_filename = f"SDA{filename_timestamp}.dat"
-        dis_filename = f"SDA{filename_timestamp}.dis"
+        base_filename = f"SDA{filename_timestamp}"
+        dat_filename = f"{base_filename}.dat"
+        dis_filename = f"{base_filename}.dis"
 
         # Usa la directory temporanea /tmp che è scrivibile su Hugging Face Spaces
         temp_dir = "/tmp"
@@ -244,12 +253,10 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
         with open(dat_filepath, 'w', encoding='utf-8') as f: # Specifica encoding utf-8
             for line in dat_content:
                 f.write(line + '\n')
-        st.success(f"File '{dat_filename}' generato con successo.")
-
+        
         with open(dis_filepath, 'w') as f:
             pass # Crea un file vuoto
-        st.success(f"File '{dis_filename}' generato con successo.")
-
+        
         return dat_filepath, dis_filepath
 
     except pd.errors.EmptyDataError:
@@ -263,6 +270,110 @@ def generate_poste_dat_file(df_shipping_mark_input, df_shipment_order_input):
         st.warning("Verifica che i nomi delle colonne nei tuoi file Excel corrispondano alle aspettative del programma, specialmente 'orderRef' e i campi relativi al destinatario. Ricorda che l'intestazione è alla seconda riga.")
         return None, None
 
+# --- Funzione per generare il testo delle specifiche del tracciato DAT ---
+def generate_dat_format_spec_text():
+    spec_text = "Specifiche del Tracciato File .DAT\n\n"
+    spec_text += "Id\tNome Campo\tObbligatorio\tTipo\tLunghezza\tInizio\tDescrizione\tDefault / Fonte Dati\n"
+    spec_text += "--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\n"
+
+    for field_spec in dat_format_spec:
+        field_id = field_spec.get('id', '')
+        display_name = field_spec['name'].replace('_', ' ').replace('fixed', '').replace('derived', '').strip().title()
+        
+        # Gestione speciale per nomi lunghi per migliorare la leggibilità
+        if display_name == 'Numero Riferimento Spedizione':
+            display_name = 'Num. Rif. Spedizione'
+        elif display_name == 'Numero Civico Destinatario':
+            display_name = 'Num. Civico Dest.'
+        elif display_name == 'Numero Telefono Destinatario':
+            display_name = 'Tel. Dest.'
+        elif display_name == 'Numero Telefono Mittente':
+            display_name = 'Tel. Mittente'
+        elif display_name == 'Codice Identificativo Cliente':
+            display_name = 'Cod. Ident. Cliente'
+        elif display_name == 'Codice Indirizzo Mittente':
+            display_name = 'Cod. Ind. Mittente'
+        elif display_name == 'Ragione Sociale Mittente':
+            display_name = 'Rag. Soc. Mittente'
+        elif display_name == 'Contatto Mittente':
+            display_name = 'Contatto Mittente'
+        elif display_name == 'Tipo Via Mittente':
+            display_name = 'Tipo Via Mittente'
+        elif display_name == 'Via Mittente':
+            display_name = 'Via Mittente'
+        elif display_name == 'Numero Civico Mittente':
+            display_name = 'Num. Civico Mitt.'
+        elif display_name == 'Cap Mittente':
+            display_name = 'CAP Mittente'
+        elif display_name == 'Localita Mittente':
+            display_name = 'Località Mittente'
+        elif display_name == 'Provincia Mittente':
+            display_name = 'Prov. Mittente'
+        elif display_name == 'Ragione Sociale Destinatario':
+            display_name = 'Rag. Soc. Destinatario'
+        elif display_name == 'Contatto Destinatario':
+            display_name = 'Contatto Destinatario'
+        elif display_name == 'Tipo Via Destinatario':
+            display_name = 'Tipo Via Destinatario'
+        elif display_name == 'Via Destinatario':
+            display_name = 'Via Destinatario'
+        elif display_name == 'Cap Destinatario':
+            display_name = 'CAP Destinatario'
+        elif display_name == 'Localita Destinatario':
+            display_name = 'Località Destinatario'
+        elif display_name == 'Provincia Destinatario':
+            display_name = 'Prov. Destinatario'
+        elif display_name == 'Numero Colli':
+            display_name = 'Num. Colli'
+        elif display_name == 'Peso Colli':
+            display_name = 'Peso Colli'
+        elif display_name == 'Codice Servizio':
+            display_name = 'Cod. Servizio'
+        elif display_name == 'Identificativo Collo':
+            display_name = 'ID Collo'
+        elif display_name == 'Filiale':
+            display_name = 'Filiale'
+        elif display_name == 'Tipo Cliente':
+            display_name = 'Tipo Cliente'
+        elif display_name == 'Id Ldv':
+            display_name = 'ID LdV'
+        elif display_name == 'Data Spedizione':
+            display_name = 'Data Spedizione'
+        elif display_name == 'Ritiro M/P':
+            display_name = 'Ritiro M/P'
+        elif display_name == 'Filler Gap 18 20':
+            display_name = 'Gap'
+
+
+        obligatory = "*" if field_spec['mandatory'] else ""
+        field_type = "char" # Tutte sono char
+        length = field_spec['length']
+        start_pos = field_spec['start_pos']
+        description = field_spec['description']
+
+        source_info = ""
+        source_type = field_spec['source']
+        if source_type == 'fixed':
+            source_info = fixed_and_default_values.get(field_spec['name'], 'N/A')
+        elif source_type == 'shipping_mark_file':
+            source_info = f"Da ShippingMark_.xlsx: '{field_spec['excel_col']}'"
+        elif source_type == 'shipment_order_file':
+            source_info = f"Da ShipmentOrder_.xlsx: '{field_spec['excel_col']}'"
+            if field_spec['name'] == 'data_spedizione':
+                source_info += " (formato AAAAMMGG)"
+            elif field_spec['name'] == 'numero_telefono_destinatario':
+                source_info += " (riempi con '0' se vuoto)"
+        elif source_type == 'filler':
+            source_info = "Spazi vuoti (Gap)"
+        
+        # Aggiusta la colonna Descrizione per non essere troppo larga nella tabella di testo
+        if len(description) > 50:
+            description = description[:47] + "..."
+
+        spec_text += f"{field_id}\t{display_name:<25}\t{obligatory:<12}\t{field_type:<4}\t{length:<9}\t{start_pos:<7}\t{description:<50}\t{source_info}\n"
+    
+    return spec_text
+
 # --- Sezione App Streamlit ---
 def app():
     st.set_page_config(layout="centered", page_title="Generatore File Poste .DAT")
@@ -289,55 +400,58 @@ def app():
             df_shipping_mark = pd.read_excel(shipping_mark_file, header=1)
             df_shipment_order = pd.read_excel(shipment_order_file, header=1)
 
-            st.write("Colonne lette da ShippingMark_:", df_shipping_mark.columns.tolist())
-            st.write("Colonne lette da ShipmentOrder_:", df_shipment_order.columns.tolist())
-
-            # DEBUGGING: Mostra il DataFrame ShipmentOrder_ dopo la lettura e il mapping
-            st.subheader("Anteprima del DataFrame ShipmentOrder_ (dopo la lettura e il mapping delle colonne):")
-            st.dataframe(df_shipment_order)
-
             # Esegui la funzione di generazione
             dat_filepath, dis_filepath = generate_poste_dat_file(df_shipping_mark, df_shipment_order)
 
-            # DEBUGGING: Per mostrare df_merged, la variabile deve essere accessibile qui.
-            # Questo richiede una piccola modifica nella funzione generate_poste_dat_file
-            # per restituire anche df_merged, oppure duplicare la logica di merge qui solo per il debug.
-            # Per semplicità, la lascio commentata qui a meno che non ci sia una richiesta specifica.
-            # Oppure puoi ispezionare df_shipment_order e le colonne mappate per vedere i dati.
-
-
         except Exception as e:
-            st.error(f"Errore nella lettura dei file Excel: {e}")
+            st.error(f"Errore: {e}")
             st.warning("Assicurati che i file siano in formato .xlsx, non siano corrotti e che l'intestazione sia effettivamente alla seconda riga.")
 
     if dat_filepath and dis_filepath:
-        st.subheader("Download dei file generati:")
+        st.subheader("File generati:")
+        st.success("I file .DAT e .DIS sono stati generati con successo e sono pronti per il download.")
         
+        # Ottieni il nome base del file (es. SDA20240101123456789)
+        base_filename = os.path.basename(dat_filepath).replace('.dat', '')
+
         # Per consentire il download in Streamlit, dobbiamo leggere il contenuto del file
         # in modalità binaria ('rb') e passarlo al download_button.
         with open(dat_filepath, "rb") as f:
             st.download_button(
-                label=f"Scarica {os.path.basename(dat_filepath)}",
+                label=f"Scarica {base_filename}.dat",
                 data=f.read(),
-                file_name=os.path.basename(dat_filepath),
-                mime="text/plain" # Tipo MIME per file di testo generici
+                file_name=f"{base_filename}.dat",
+                mime="text/plain", # Tipo MIME per file di testo generici
+                key="download_dat_btn"
             )
         
         with open(dis_filepath, "rb") as f:
             st.download_button(
-                label=f"Scarica {os.path.basename(dis_filepath)}",
+                label=f"Scarica {base_filename}.dis",
                 data=f.read(),
-                file_name=os.path.basename(dis_filepath),
-                mime="text/plain"
+                file_name=f"{base_filename}.dis",
+                mime="text/plain",
+                key="download_dis_btn"
             )
 
+    st.markdown("---")
+    st.subheader("Specifiche del Tracciato .DAT")
+    st.markdown("Qui puoi scaricare un file di testo con la descrizione dettagliata del formato del file .DAT generato:")
+    
+    spec_text_content = generate_dat_format_spec_text()
+    
+    st.download_button(
+        label="Scarica Specifiche Tracciato DAT",
+        data=spec_text_content.encode('utf-8'),
+        file_name="DAT_Format_Specification.txt",
+        mime="text/plain",
+        key="download_spec_btn"
+    )
+
     st.markdown("---")
     st.info("""
-        **Nota sulle colonne:**
-        Assicurati che i tuoi file Excel contengano le colonne corrette.
-        - Il file `ShippingMark_` deve contenere le colonne 'shippingMark', 'orderRef', 'totalWeight' e 'totalVolume'.
-        - Il file `ShipmentOrder_` deve contenere 'orderRef', 'orderDate' e i campi specifici del destinatario (es. 'consegnee.partner.businessname', 'consegnee.partner.address.address', ecc.).
-        I nomi delle colonne nel tuo file `ShipmentOrder_` devono corrispondere **esattamente** (ignorando maiuscole/minuscole) ai nomi completi con la notazione a punti (es. 'consegnee.partner.address.address') per un corretto mapping.
+        **Nota importante sui nomi delle colonne nei tuoi file Excel:**
+        Assicurati che le colonne nel tuo file `ShipmentOrder_` corrispondano **esattamente** ai nomi con la notazione a punti (es. 'consegnee.partner.businessname', 'consegnee.partner.address.address', 'orderdate') una volta letti da Excel con l'intestazione alla seconda riga.
         """)
 
 if __name__ == "__main__":