FatturaElettronicaFtPA - Plugin VTENEXT per la fatturazione elettronica (FtPA / TosNet)
=======================================================================================

Versione: 1.0.0
Compatibilita': VTENEXT >= 25.02 (testato su 26.04, PHP 8.3)
Provider: FtPARest v2.10 (TosNet) - whitelabel Pantarei

DESCRIZIONE
-----------
Invio delle FATTURE ATTIVE a SDI tramite il servizio REST FtPA, usando l'endpoint
/crea_xml_semplificato (VTE invia JSON strutturato, FtPA genera l'XML FatturaPA).
Polling automatico degli esiti SDI tramite cron.

REQUISITI
---------
- Estensione PHP cURL e openssl abilitate.
- Credenziali FtPA (username/password) e, per la produzione, URL whitelabel.
- Cron VTE attivo (per il polling degli esiti).

INSTALLAZIONE
-------------
1. Impostazioni > Gestione Moduli > Importa modulo dallo ZIP, oppure
   posizionare la cartella in modules/ e registrare il modulo.
2. Aprire Impostazioni > LBL_FE_FTPA_SETTINGS (o modules/FatturaElettronicaFtPA/Settings.php)
   e configurare ambiente, credenziali e dati cedente.
3. Eseguire "Test connessione" per verificare raggiungibilita' e credenziali.

CAMPI AGGIUNTI
--------------
Accounts (blocco "Fatturazione elettronica"):
  fe_codice_destinatario, fe_pec_destinatario, fe_codice_ipa,
  fe_formato_trasmissione, fe_tipo_soggetto
Invoice (blocco "Fattura elettronica"):
  fe_tipo_documento, fe_natura, fe_status, fe_ftpa_seriale,
  fe_identificativo_sdi, fe_data_invio, fe_ultima_ricevuta, fe_errore

Tabella: <prefix>_ftpa_invoice_map (mapping fattura <-> documento FtPA).

USO
---
Nella scheda (DetailView) di una Fattura compaiono i pulsanti:
  - "Valida / Anteprima": valida i dati e mostra il payload che verra' inviato.
  - "Invia a SDI": invia la fattura tramite FtPA e registra seriale/stato.
Il cron "FatturaElettronicaFtPA_Poll" aggiorna periodicamente gli stati SDI.

DISINSTALLAZIONE
----------------
Da Gestione Moduli: rimuove campi, blocchi, picklist, tabella di mapping,
cron, voce impostazioni, traduzioni, configurazione e i file del modulo,
senza lasciare orfani in DB.

NOTE TECNICHE
-------------
- prezzounitario x quantita == prezzototale (coerenza XSD; sconti gia' applicati al netto).
- importototaledocumento calcolato dal castelletto (somma imponibile + imposta).
- Righe a IVA 0 richiedono la "Natura FE" sulla fattura.
- Le credenziali sono cifrate (AES-256) con chiave derivata da application_unique_key.

(c) Pantarei Informatica Srl - Tutti i diritti riservati
