Carrello
Non ci sono più articoli nel tuo carrello
Tec Fattura24 Connector è il modulo Tecnoacquisti che collega PrestaShop a Fattura24 senza interventi manuali. Ogni ordine viene inviato al servizio di fatturazione quando raggiunge lo stato configurato, con regole indipendenti per ogni tipo di documento fiscale o commerciale.
Come funziona
Il modulo ascolta l'hook actionOrderStatusUpdate di PrestaShop. Quando un ordine cambia stato, il connettore verifica se esiste una regola attiva per quello stato e, in caso affermativo, genera il documento XML e lo invia a Fattura24 tramite l'API SaveDocument. L'intero flusso è registrato in una tabella dedicata, consultabile direttamente dalla pagina ordine nel back-office.
Tipi di documento supportati
| Codice | Tipo documento | Utilizzo tipico |
|---|---|---|
FE |
Fattura elettronica | Fatturazione elettronica italiana con SDI/PEC. |
I |
Fattura | Fattura standard Fattura24. |
I-force |
Fattura forzata | Flusso fattura forzata Fattura24. |
R |
Corrispettivo/Ricevuta | Flusso corrispettivi per vendite B2C. |
C |
Ordine cliente | Documento commerciale non fiscale con numerazione e-commerce. |
Funzionalità principali
- Regole documento indipendenti: ogni tipo di documento ha il proprio stato trigger, numeratore, template e opzioni di invio.
- Test chiave API: pulsante di verifica dalla pagina di configurazione prima di attivare le regole in produzione.
- Invio email da Fattura24: opzionale per tipo di regola, disabilitabile durante i test.
- Segna come pagato: scrive
Paid=truenel nodo pagamento Fattura24 quando l'ordine è confermato. - Ordini a importo zero: gestione configurabile per regola (abilitabile per ordini omaggio o a saldo zero).
- Numerazione personalizzata: per gli ordini cliente (
C), numero costruito con token configurabili: anno, ID ordine, codice shop, riferimento ordine. - Idempotenza:
idRequestunivoco per tipo documento, ordine e shop, per evitare duplicati in caso di retry. - Lock MySQL: named lock per prevenire invii concorrenti dello stesso ordine e tipo documento.
- Integrazione ArteInvoice: lettura automatica dei campi SDI e PEC dall'indirizzo di fatturazione quando disponibili.
- Log debug: opzionale tramite
PrestaShopLogger, da attivare solo in fase di test o diagnosi.
Configurazione
Dalla pagina di configurazione del modulo si impostano prima i parametri API comuni, poi le regole documento.
| Campo | Descrizione |
|---|---|
| Chiave API | Chiave Fattura24, visualizzata mascherata. Lasciare invariata per conservare il valore salvato. |
| Timeout HTTP | Secondi di attesa per le risposte API. Valori fuori dall'intervallo 5–120 vengono normalizzati a 60. |
| Debug log | Scrive messaggi diagnostici su PrestaShopLogger. Abilitare solo in fase di test. |
| Numeratore ID | ID numeratore Fattura24 opzionale. Vuoto = numeratore predefinito dell'account. |
| Template ID | ID template Fattura24 opzionale. Vuoto = template predefinito dell'account. |
| Codice shop | Codice breve per la numerazione documenti in ambienti multi-shop. Default: SHOP + ID shop. |
Pannello ordine nel back-office
La pagina ordine di PrestaShop mostra per ogni ordine:
- Le regole documento attive e i loro stati trigger.
- La cronologia degli invii con stato (
pending,sent,error), ID documento Fattura24, risposta API e contatore tentativi. - Il pulsante Invia o riprova per ogni tipo di documento abilitato, con token dipendente dall'operatore autenticato.
Flusso di invio
- L'ordine cambia stato in PrestaShop.
- Il modulo individua le regole attive il cui trigger corrisponde al nuovo stato.
- Per ogni regola, gli ordini a importo zero vengono saltati salvo abilitazione esplicita.
- Viene acquisito un lock MySQL per ordine, shop e tipo documento.
- Viene creata o aggiornata una riga in
tecfattura24_document. - Il modulo genera il documento XML con indirizzo di fatturazione, righe prodotto, sconti, spedizione e pagamento.
- Viene chiamata l'API
SaveDocumentdi Fattura24. - In caso di successo la riga viene marcata
sent; in caso di errore viene marcataerrored è disponibile il retry manuale.
Requisiti
- PrestaShop 1.7.8.11 o successivo (testato fino a 9.1).
- Estensione PHP cURL abilitata.
- Chiave API Fattura24 valida.
- Almeno una regola documento abilitata con stato d'ordine configurato.
- Dati di indirizzo di fatturazione compatibili con il tipo documento scelto in Fattura24.
Prima di attivare le regole in produzione, utilizza il pulsante Test chiave API e verifica il flusso con tipo documento
C o R e le opzioni email e pagato disabilitate.Normativa e responsabilità
Prima dell'utilizzo in produzione è necessario verificare il regolamento API Fattura24 e il regolamento e-commerce Fattura24. Il merchant rimane responsabile della correttezza fiscale dei dati inviati, dello stato dei documenti in Fattura24 e degli esiti SDI per la fatturazione elettronica.
Licenza e supporto
Modulo sviluppato da Tecnoacquisti.com - Arte e Informatica di Loris Modena e C. s.a.s.
Per assistenza: helpdesk@tecnoacquisti.com oppure visita tecnoacquisti.com.
