VibeFox Econt for PrestaShop — Guida

Requisiti

PrestaShop: 8.0–9.x.

PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.

Econt: non servono un contratto o una chiave API. L'elenco degli uffici è una nomenclatura pubblica di Econt. Viene inviato a Econt solo il codice del paese, nessun dato del cliente. Inserisci un nome utente e una password e-Econt solo se Econt chiede al tuo negozio un'autorizzazione. L'accesso e-Econt è descritto nella pagina per sviluppatori di Econt (econt.com/developers).

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

1. Nel back office vai su Modules > Module Manager e clicca su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento clicca su Configure, oppure trova più tardi VibeFox Econt nell'elenco dei moduli e clicca su Configure.

3. Inserisci la chiave di licenza VibeFox in License key, nel blocco licenza in cima alla pagina Configure, e clicca su Activate (vedi Chiave di licenza).

4. Imposta le tariffe per paese e controlla le altre opzioni (vedi Configurazione), poi clicca su Save. Clicca su Load offices from Econt now per verificare la connessione.

All'installazione il modulo crea il corriere Econt Express con il testo dei tempi di consegna Delivery to an Econt office or Econtomat. Il corriere è assegnato alle zone di Bulgaria e Romania e a tutti i gruppi di clienti. Puoi modificare zone, gruppi di clienti, tempi di consegna, logo e limiti di dimensione in Shipping > Carriers. Non impostare lì le tariffe: il prezzo proviene sempre dal modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox Econt > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina. Tariffa e condizioni si applicano a tutte le zone del corriere.

In cima alla pagina il modulo mostra avvisi: corriere Econt non trovato, API demo attiva, nessuna tariffa impostata per Bulgaria o Romania (in tal caso il corriere non viene mai mostrato), ultima richiesta di uffici per un paese non riuscita, oppure unità di peso del negozio non riconosciuta dal modulo (in tal caso i pesi sono considerati in kg; imposta l'unità in International > Localization, Local units). I campi numerici accettano la virgola decimale, per esempio 5,99. Se un campo numerico contiene qualcosa che non è un numero o un numero negativo, oppure se Minimum weight (kg) è maggiore di Maximum weight (kg), un errore indica il campo e non viene salvato nulla.

Generale

Enable/Disable: attiva o disattiva la consegna Econt. È lo stesso interruttore dello stato del corriere in Shipping > Carriers.

Name: il nome del corriere mostrato nel carrello e al checkout. Predefinito: Econt Express. Obbligatorio, massimo 64 caratteri.

Tax: la regola fiscale del corriere, oppure No tax. PrestaShop aggiunge questa imposta alle tariffe sotto. Con No tax le tariffe sono definitive.

Elenco uffici Econt

Uffici ed Econtomat vengono caricati dall'API Econt e memorizzati nella cache per 24 ore.

Demo API: usa l'API demo di Econt con dati di prova. Tienila disattivata su un negozio attivo. Gli uffici demo hanno ID diversi da quelli reali. In modalità demo si usa l'account di prova pubblico di Econt quando non è impostato alcun accesso.

Econt username: facoltativo. Il tuo accesso e-Econt per l'autorizzazione HTTP Basic.

Econt password: facoltativa. Viene salvata nel database del negozio e non viene mai scritta nel registro. Dopo il salvataggio il campo resta vuoto e mostra Saved - leave empty to keep it. Inserisci un nuovo valore solo per modificarlo. Spunta Remove the saved password e salva per eliminarla.

Office list: mostra quanti uffici sono memorizzati nella cache per paese e quando sono stati caricati. Il pulsante Load offices from Econt now ricarica subito gli elenchi e mostra il risultato per paese. Se un caricamento fallisce, restano gli uffici dell'ultimo caricamento riuscito. Senza questo pulsante l'elenco viene caricato automaticamente al primo checkout. Modificare Demo API, il nome utente o la password cancella gli elenchi in cache.

Selettore dell'ufficio al checkout

Show: quali punti possono scegliere i clienti.

City order: mostra prima le città più grandi (Sofia, Plovdiv, Varna, Bucarest e altre). Se disattivata, le città sono ordinate alfabeticamente. Predefinito: attivo.

City list width: la larghezza CSS dell'elenco delle città, per esempio 100% o 300px. Predefinito: 100%.

Office list width: la larghezza CSS dell'elenco degli uffici, per esempio 100% o 400px. Predefinito: 100%.

Tariffe (il titolo della sezione mostra la valuta predefinita del tuo negozio)

Le tariffe sono nella valuta predefinita del tuo negozio, IVA esclusa. Il modulo non chiede a Econt tariffe in tempo reale. La Bulgaria usa l'euro dal 1° gennaio 2026, quindi un negozio bulgaro di norma inserisce tariffe in EUR.

Price per country: un paese per riga (o separati da virgole): codice paese, due punti, tariffa, per esempio BG:5.99 e RO:8.99 (sono i valori predefiniti). Va bene anche la virgola decimale: BG:5,99. Una tariffa di 0 significa consegna gratuita. Se il campo è vuoto si usano le tariffe predefinite BG:5.99 e RO:8.99 (con Ignore zones, i paesi fuori dalle zone del corriere non ricevono allora alcuna tariffa). Le voci in un altro formato vengono ignorate ed elencate in un avviso al salvataggio. Il resto viene salvato.

Calculation: Per order addebita la tariffa una sola volta. Per item (price x quantity) la moltiplica per il numero di articoli da spedire.

Price for other countries: usata per un paese Econt (Bulgaria o Romania) non elencato sopra. Vuoto o 0 nasconde il corriere in quel paese.

Condizioni

Il subtotale del carrello indica i prodotti da spedire, dopo gli sconti e prima delle imposte.

Free shipping from: il subtotale del carrello da cui la consegna è gratuita. Lascia vuoto per non offrire mai la consegna gratuita.

Minimum subtotal: mostra il corriere solo quando il subtotale del carrello è almeno questo importo. Lascia vuoto per mostrarlo sempre.

Minimum weight (kg): nasconde il corriere per carrelli più leggeri. I pesi dei prodotti vengono convertiti dall'unità di peso del negozio in kg. Lascia vuoto per nessun limite.

Maximum weight (kg): nasconde il corriere per carrelli più pesanti. Lascia vuoto per nessun limite.

Disponibilità senza zone di spedizione

Ignore zones: offri Econt anche nei paesi sotto quando la zona dell'indirizzo di consegna non è collegata al corriere. Quando lo attivi, il corriere viene collegato a ogni zona attiva, e vengono collegate anche le zone create dopo. Quando lo disattivi di nuovo, il corriere riottiene le zone che aveva prima. Le zone già collegate continuano a funzionare come di consueto. Econt continua a essere offerta solo per Bulgaria e Romania.

Countries: Bulgaria e/o Romania. Usato solo con Ignore zones. Se nessuno è selezionato, vale per tutti i paesi Econt verso cui il negozio spedisce.

Avanzate

Debug log: scrive messaggi di debug in logs/vfd_ecn_debug.log.php, nella cartella del modulo. Il file non può essere aperto dal web. Gli errori dell'API vengono sempre registrati. Non vengono scritte password né dati dei clienti.

Log: mostra la dimensione e le ultime voci del registro. Clicca su Clear log per svuotarlo.

Remove data on uninstall: se attivo, la disinstallazione del modulo elimina le impostazioni Econt, il corriere e il registro. Se disattivo, le impostazioni vengono conservate per una nuova installazione. Gli uffici salvati negli ordini vengono sempre conservati.

Come funziona al checkout

Il corriere viene offerto solo per Bulgaria e Romania. Nel passo di spedizione PrestaShop chiede al modulo la tariffa Econt. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel subtotale. Il modulo verifica i limiti di peso e il subtotale minimo, poi prende la tariffa del paese. Se il subtotale del carrello raggiunge Free shipping from, la tariffa è 0. Se per il paese non c'è un elenco di uffici, il corriere viene nascosto, perché la consegna avviene sempre presso un ufficio. La tariffa viene calcolata nella valuta predefinita e poi mostrata nella valuta del carrello del cliente.

Quando il cliente seleziona Econt, sotto il corriere compaiono due elenchi: City e Office / Econtomat. L'elenco degli uffici viene caricato una volta per pagina, solo quando è selezionato Econt. Gli Econtomat sono contrassegnati nell'elenco. La scelta viene salvata subito nel carrello. Se l'elenco degli uffici non può essere caricato, il cliente vede Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.

Quando il cliente clicca su Continue nel passo di spedizione, il modulo verifica sul server che sia scelto un ufficio e che esista nell'elenco Econt per il paese di consegna (filtrato da Show). Senza ufficio il cliente vede Please select an Econt office or Econtomat. Un ufficio non presente nell'elenco viene rifiutato con The selected Econt office is not available for the shipping country. Please select it again. Il nome dell'ufficio viene sempre preso dall'elenco Econt, non dal browser. Il selettore funziona con il tema Classic e con Hummingbird.

L'elenco degli uffici viene memorizzato nella cache per 24 ore, separatamente per l'API live e quella demo. Se Econt non risponde, si usa l'ultimo elenco valido e Econt non viene interrogata di nuovo per 10 minuti. Il timeout dell'API è di 15 secondi. L'elenco degli uffici proviene da https://ee.econt.com/services/ (live) oppure da https://demo.econt.com/ee/services/ (demo).

Se modifichi il corriere in Shipping > Carriers dopo che ha degli ordini, PrestaShop lo salva come nuova versione del corriere. Il modulo segue automaticamente la nuova versione.

Il modulo usa solo tariffe fisse. Non chiede a Econt tariffe in tempo reale, non crea lettere di vettura o etichette, non prenota corrieri, non traccia le spedizioni, non gestisce il contrassegno e non consegna a un indirizzo. Solo Bulgaria e Romania hanno un elenco di uffici.

Punti di ritiro

Quando l'ordine viene effettuato, con esso viene salvato l'ufficio scelto per il carrello: la città, il nome e l'indirizzo dell'ufficio e il codice ufficio Econt. Usa il codice dell'ufficio quando crei la spedizione in e-Econt.

Pagina dell'ordine nel back office: un blocco Econt office / Econtomat mostra l'ufficio e l'Office code. Sotto Change scegli un'altra città e un altro ufficio del paese dell'ordine e clicca su Save. La modifica viene salvata subito e un messaggio privato sull'ordine registra il vecchio e il nuovo ufficio. Se clicchi su Save senza scegliere un ufficio, il blocco dice Select a city and an office first - nothing was changed. Qualsiasi dipendente autorizzato a modificare gli ordini può cambiare l'ufficio; non serve l'accesso alla pagina del modulo. Se l'elenco degli uffici non può essere caricato, il blocco mostra Econt offices cannot be loaded right now.

Più ordini dallo stesso carrello: l'ufficio appartiene al primo ordine. Un altro ordine effettuato dallo stesso carrello non riceve un ufficio: nel registro viene scritto un errore e il suo blocco indica che l'ufficio di questo carrello appartiene a un altro ordine. Concorda l'ufficio con il cliente e crea la spedizione manualmente in e-Econt.

Cliente: l'ufficio viene mostrato nella pagina dell'ordine del cliente e nella pagina di conferma dell'ordine, e viene aggiunto al nome del corriere nell'e-mail di conferma dell'ordine e nell'e-mail di nuovo ordine inviata al negozio.

I nomi degli uffici vengono mostrati nella lingua locale (cirillico per la Bulgaria) quando la lingua del negozio è il bulgaro o il rumeno, e in inglese negli altri casi.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza License — VibeFox Econt è il primo blocco di Modules > Module Manager > VibeFox Econt > Configure, sopra le impostazioni. Inserisci la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto compaiono la riga Product: presta-shipping-econt e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con il permesso Configure per il modulo possono modificare la chiave. I testi del blocco seguono la lingua del back office (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached oppure License expired on seguito da una data. Dopo una modifica dell'indirizzo del negozio, o dopo aver liberato un posto dominio nel tuo account, clicca su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: quello del negozio principale, anche in una configurazione multistore. Rimuovere la chiave dal negozio non libera il suo posto dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, il corriere Econt non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. La vetrina di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il corriere viene nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non testarlo al checkout. Un promemoria compare in Modules > Module Manager nella scheda Alerts. Gli ordini esistenti non sono interessati.

Quando una licenza scade, il modulo continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. Disinstallare o reimpostare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Econt non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable sia attivo, e che il paese di consegna sia Bulgaria o Romania. In Shipping > Carriers verifica che il corriere copra la zona del paese del cliente e il gruppo del cliente (oppure attiva Ignore zones e controlla Countries). Verifica che sia impostata una tariffa per il paese, i limiti di peso e Minimum subtotal. Controlla la riga Office list nelle impostazioni: il corriere è nascosto finché non c'è un elenco di uffici per il paese. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto.

L'elenco degli uffici non si carica: clicca su Load offices from Econt now e leggi il risultato, oppure l'avviso in cima alla pagina delle impostazioni. Gli errori vengono sempre scritti nel registro; attiva Debug log per più dettagli e controlla il campo Log. Se Econt richiede un'autorizzazione per il tuo negozio, compila Econt username e Econt password.

I clienti vedono uffici di prova: Demo API è attiva. Disattivala su un negozio attivo.

In quale valuta sono le tariffe? Nella valuta predefinita del tuo negozio, IVA esclusa. I clienti le vedono nella valuta del loro carrello.

L'imposta viene aggiunta sopra la tariffa: il corriere ha una regola fiscale. Imposta Tax su No tax se le tue tariffe includono già l'IVA.

La pagina dice che il corriere Econt non è stato trovato: il corriere è stato eliminato in Shipping > Carriers. Reimposta il modulo in Modules > Module Manager per crearlo di nuovo.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox Econt e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi. Gli elenchi degli uffici in cache vengono sempre rimossi. Se Remove data on uninstall è attiva, il corriere viene eliminato (gli ordini conservano la cronologia) e vengono rimosse le impostazioni e il registro. Se è disattiva, il corriere viene solo disattivato e tutte le impostazioni vengono conservate. Reinstallando il modulo viene ripristinato il corriere salvato con lo stato che aveva. Reimpostare il modulo mantiene lo stato attuale del corriere. Gli uffici salvati negli ordini vengono sempre conservati.

Econt è un marchio del rispettivo proprietario. Questo modulo non è affiliato a Econt né approvato da Econt.