Servizio clienti e confezionamento degli ordini sul tuo telefono: scopri l'app PrestaShop Pocket 📦
- Tassi di cambio aggiornati della Banca Nazionale Polacca (NBP) nel tuo negozio PrestaShop
- Tasso di cambio NBP aggiornato sugli ordini
- Tasso di cambio manuale – prezzo visibile al cliente
- Tutte le operazioni relative ai tassi di cambio in un unico posto
- Automazione in background — un token, due opzioni
- Sicurezza
- A chi è rivolto PrestaShop NBP?
- Facilitazioni per gli sviluppatori
- Hook di PrestaShop
- Requisiti tecnici
Descrizione dettagliata
Tassi di cambio direttamente dalla Banca Nazionale Polacca (NBP) — feed ufficiale
Per impostazione predefinita, PrestaShop recupera i tassi di cambio da una propria fonte esterna ancorata all’euro, non collegata alla Banca Nazionale Polacca. Il nostro modulo sostituisce tali tassi con la tabella ufficiale e pubblica dei tassi di cambio della Banca Nazionale Polacca.
Automazione in background — link URL e CRON
Un unico token protetto gestisce il CRON — è compatibile sia con l’hosting condiviso che con un server con accesso SSH.
Tasso di cambio aggiuntivo, impostabile manualmente, per il ricalcolo del prezzo del prodotto — soluzione pronta per la fattura
Indipendentemente dal tasso di cambio della Banca Nazionale Polacca, è possibile impostare un tasso aggiuntivo da utilizzare per la conversione dei prezzi dei prodotti. Si tratta di un tasso non visibile al cliente. Ad ogni ordine in valuta estera viene assegnato il tasso reale della Banca Nazionale Polacca in vigore alla data dell’acquisto.
Conformità con la NBP
I tassi di cambio vengono scaricati direttamente dall’API ufficiale e pubblica api.nbp.pl — tabella A (valute principali, quotidianamente) o B (altre valute, una volta alla settimana).
La valuta predefinita del negozio non viene mai modificata: il suo tasso di cambio rimane sempre pari a 1, in conformità con i requisiti di PrestaShop.
Controllo sul tasso di cambio per la conversione dei prezzi
Imposta un tasso di cambio fisso personalizzato per qualsiasi valuta — ad esempio per promozioni o test — con anteprima della conversione in tempo reale nel browser.
Il tasso di cambio di riferimento della Banca Nazionale Polacca (NBP) continua a essere monitorato in background, indipendentemente dal tasso impostato manualmente.
Nessun intervento manuale sulle fatture
A ogni ordine in valuta estera viene associato il tasso di cambio della Banca Nazionale Polacca (NBP) del giorno dell’acquisto o del giorno lavorativo precedente.
Si tratta dell’unica funzionalità di questo tipo tra i moduli di cambio per PrestaShop.
- Quando viene effettuato un ordine in valuta estera, il modulo preleva il tasso di cambio attuale dal tasso di riferimento della Banca Nazionale Polacca (NBP) scaricato in precedenza: il checkout non si collega alla Banca Nazionale Polacca, quindi eventuali malfunzionamenti della stessa non influiscono sul momento dell’invio dell’ordine.
- Il tasso di cambio attuale sovrascrive il campo conversion_rate dell’ordine in PrestaShop, utilizzato dai report e dalle statistiche.
- L’importo pagato dal cliente non cambia mai: i dati vengono salvati al momento della creazione dell’ordine.
- L’insieme completo dei dati viene inserito in una tabella separata: tasso di cambio dal checkout, tasso di cambio effettivo della NBP, tabella e data della NBP, importi lordi/netti convertiti nella valuta predefinita del negozio.
A volte il negozio vuole mostrare al cliente prezzi diversi da quelli risultanti da una conversione diversa da quella di mercato – per esigenze promozionali, arrotondamenti o test.
- Inserisci un tasso di cambio uguale a quello della Banca Nazionale Polacca (NBP) o qualsiasi altro.
- Anteprima della conversione in tempo reale nel browser, prima ancora di salvare.
- Cancellando il campo si ripristina la conversione automatica dalla Banca Nazionale Polacca (NBP).
- Il tasso di cambio di riferimento della Banca Nazionale Polacca (NBP) è sempre visibile e aggiornato accanto, indipendentemente dal tasso di cambio manuale impostato.
- All’ordine vengono allegate due informazioni: il tasso di cambio della Banca Nazionale Polacca (NBP) – ai fini contabili – e il tasso di cambio manuale – ai fini del calcolo dei prezzi.
Il pannello del modulo mostra ogni valuta del negozio in una singola riga: il tasso di cambio attuale della Banca Nazionale Polacca (punto di riferimento), il tasso di cambio impostato manualmente — visibile al cliente — e lo stato chiaramente leggibile.
- Tasso di cambio attuale: il tasso di cambio della Banca Nazionale Polacca (NBP), indipendente e costantemente aggiornato, visibile anche per le valute con tasso di cambio impostato manualmente.
- Tasso di cambio visibile al cliente – quello che viene effettivamente inviato al campo conversion_rate di PrestaShop e determina i prezzi sul front-end.
- Stato: Predefinito, Aggiornato, Tasso manuale, Escluso o Inattivo.
- Il pulsante «Aggiorna ora» funziona sempre, indipendentemente dall’automazione in background.
- Opzione 1 — link URL – per pannelli di controllo come home.pl, OVH, nazwa.pl o cron-job.org, che avviano il cron solo tramite richiamo dell’indirizzo.
- Opzione 2 — crontab — riga di comando pronta all’uso per server con accesso SSH.
- Il token può essere revocato in qualsiasi momento e ne può essere generato uno nuovo con un solo clic.
Token casuale e rigenerabile
Il link per l’aggiornamento automatico contiene un token segreto: senza di esso, il server restituisce un errore 403 Forbidden. Il token può essere annullato in qualsiasi momento e se ne può generare uno nuovo con un solo clic nel pannello di controllo.
Token casuale e rigenerabile
Il link per l’aggiornamento automatico contiene un token segreto: senza di esso, il server restituisce l’errore 403 Forbidden. Il token può essere revocato in qualsiasi momento e ne può essere generato uno nuovo con un solo clic nel pannello di controllo.
Un unico endpoint, nessun duplicato
Entrambe le opzioni di cron (link URL e crontab) puntano esattamente allo stesso luogo protetto: non esiste uno script separato che possa aggirare la verifica del token.
Studi contabili e contabilità del negozio
Dati pronti e documentati per la fatturazione in valuta estera, conformi al requisito di utilizzo del tasso di cambio NBP — senza dover cercare manualmente il tasso di cambio del giorno dell’ordine.
Negozi di prova e di sviluppo
Pieno controllo sul tasso di cambio visualizzato al cliente, indipendente dal tasso reale della Banca Nazionale Polacca (NBP) monitorato in background — comodo per testare prezzi e conversioni.
Facilitazioni per gli sviluppatori
- L’intera logica dei tassi di cambio risiede in servizi indipendenti (NbpClient, CurrencyRateUpdater, OrderRealRateApplier) — facili da espandere e riutilizzare.
- Tabella dedicata ps_pshownbp_order_rate (una riga per ogni ordine) — carico minimo sul database, pronta per essere letta dal proprio generatore di fatture.
- Coperto da test unitari PHPUnit — introduzione sicura delle proprie modifiche.
Hook di PrestaShop
- actionValidateOrder – salvataggio del tasso di cambio attuale della Banca Nazionale Polacca (NBP) e dei dati per la fattura al momento dell’invio dell’ordine.
Requisiti tecnici
Compatibile con le versioni attuali di PrestaShop e PHP.
- PrestaShop: 1.7.x, 8.x e 9.x
- PHP: 7.1 o versioni successive
- Accesso in uscita HTTPS a api.nbp.pl — API pubblica e gratuita della Banca Nazionale Polacca (NBP), senza chiave né registrazione
- Nessuna dipendenza esterna – non richiede librerie aggiuntive
Changelog (0)
## 1.2.30 - 2026-09-11
-----
* Fixed: right after installing, reinstalling, or upgrading the module, orders placed in that
short window could keep the checkout rate instead of getting the real NBP rate for invoicing.
New orders placed any time after that already worked correctly — this closes that narrow gap.
## 1.2.29 - 2026-09-11
-----
* Fixed: if your shop's main currency wasn't covered by the selected NBP table (e.g. table B with
a main currency like USD or EUR), none of your other currencies got updated either, even ones
the table did cover. Fixed — the main currency's rate is now fetched automatically when needed.
## 1.2.28 - 2026-09-11
-----
* Fixed: after switching the NBP table, a currency no longer covered by the new table could keep
showing its old rate as if it were still current. It now correctly shows as unmatched instead.
## 1.2.27 - 2026-09-11
-----
* Fixed: on PrestaShop 9, the automatic-update link could be blocked by the server before it even
reached the module, so scheduled updates never actually ran. Fixed.
## 1.2.26 - 2026-09-11
-----
* Fixed: the module was still showing the wrong publisher name in the back-office modules list.
## 1.2.25 - 2026-09-09
-----
* Fixed: in some cases, saving a manual rate or running an update could report success but the
rate wouldn't actually be applied. Rate updates now always take effect reliably.
## 1.2.24 - 2026-09-09
-----
* Security: the module's own test scripts are now restricted to command-line use only, so they
can't be triggered by a direct web request on hosting setups that don't already block that on
their own (e.g. Nginx).
## 1.2.23 - 2026-09-09
-----
* Improved: the suggested automatic-update schedule now runs early every morning (including
weekends) instead of once on business-day afternoons, so orders placed any time of day always
get the correct rate, not one left over from the previous run. Explained in the settings page
and the manual.
## 1.2.22 - 2026-09-09
-----
* Changed: every update (manual or automatic) now uses the exchange rate from the last business
day before today, not today's own rate — required by Polish law for VAT invoicing, and correct
no matter what time of day the update runs. Explained on the settings page and in the manual.
## 1.2.21 - 2026-09-09
-----
* Fixed: on PrestaShop versions older than 1.7.4, syncing rates for more than one shop in a row
could mix up currency rates between shops. Fixed for every supported PrestaShop version, from
1.7.0 onward.
## 1.2.20 - 2026-09-09
-----
* Fixed: the PL/EN tabs on the in-admin manual page could stop switching depending on which
PrestaShop version/theme was rendering the page. They now work the same way everywhere.
## 1.2.19 - 2026-09-09
-----
* Fixed: technical log entries (visible under Advanced Parameters > Logs) were a mix of Polish and
English regardless of the shop's admin language. They're now consistently in English, like other
technical/developer-facing log entries.
## 1.2.18 - 2026-09-09
-----
* Fixed: in the rare case of a database hiccup while recording the invoicing audit trail, the order
could end up with its rate changed but no audit record to show for it. The two are now saved
together — if either fails, neither one does.
## 1.2.17 - 2026-09-09
-----
* New: order pages now show the real NBP rate used for invoicing right next to the rate the
customer actually paid at checkout, plus both totals converted to your shop's default currency —
no more digging through the database to see it.
## 1.2.16 - 2026-09-09
-----
* Fixed: the automatic-update link now works reliably even while the shop is in maintenance mode
or has SSL/multilingual redirects — it no longer depends on the shop's normal page routing.
## 1.2.15 - 2026-09-09
-----
* Improved: "Update now" now shows a clear warning when the selected NBP table doesn't cover any
of the shop's currencies, instead of a misleading "success" message.
## 1.2.14 - 2026-09-09
-----
* Fixed: an unused generic settings page could show a confusing, empty form — it now takes you to the real settings on the "Currency rates" page instead.
## 1.2.13 - 2026-09-09
-----
* Fixed: uninstalling the module now removes all of its data, so reinstalling starts from a completely clean state.
## 1.2.12 - 2026-09-09
-----
* Fixed: module name and description now display correctly in English store back offices.
## 1.2.11 - 2026-09-09
-----
* Fixed: the module's currency rates are no longer overwritten by PrestaShop's built-in currency updater.
## 1.2.10 - 2026-09-09
-----
* Fixed: automatic update status is now correctly reported when the feature is turned off.
## 1.2.9 - 2026-09-09
-----
* Improved: more reliable connection when fetching rates from NBP, with clearer error messages if it fails.
## 1.2.8 - 2026-09-09
-----
* Fixed: order invoicing data could be incorrectly overwritten in rare duplicate-processing cases (e.g. a payment retry).
## 1.2.7 - 2026-09-09
-----
* New: added an "A + B" NBP table option, so currencies from both NBP tables can be tracked at once.
## 1.2.6 - 2026-09-09
-----
* Fixed: excluding a currency now takes effect immediately, without waiting for the next update.
## 1.2.5 - 2026-09-09
-----
* Fixed: clearing a manual rate field now correctly reverts that currency to the NBP rate.
## 1.2.4 - 2026-09-09
-----
* Fixed: invalid manual rates are now rejected with a clear error instead of being silently ignored.
## 1.2.3 - 2026-09-09
-----
* Fixed: manual rates can now be entered using a comma as the decimal separator (e.g. "4,5").
## 1.2.2 - 2026-09-04
-----
* Fixed: excluded currencies are now fully left untouched by the module.
* Fixed: manual rates for other currencies are no longer lost when saving settings.
* Fixed: an issue that could prevent invoicing data from being saved for an order.
* Improved: failed automatic updates are now clearly reported instead of failing silently.
* New: multistore support — one automatic update now refreshes rates for every shop.
## 1.2.1 - 2026-09-04
-----
* Fixed: invoices now show the correct NBP rate date.
* Improved: checkout reliability when recording invoicing data.
* Improved: automatic update schedule now matches NBP's publication time.
## 1.2.0 - 2026-09-02
-----
* New: orders now record the real NBP rate for invoicing/accounting, separate from the rate shown to customers at checkout.
## 1.1.0 - 2026-08-19
-----
* New: set your own customer-facing exchange rate per currency, automatically converted for the storefront.
## 1.0.0 - 2026-08-18
-----
* Initial release — automatic currency rate updates from NBP, manual and automatic (cron) update options, per-currency exclusion list, PL/EN documentation.
-----
* Fixed: right after installing, reinstalling, or upgrading the module, orders placed in that
short window could keep the checkout rate instead of getting the real NBP rate for invoicing.
New orders placed any time after that already worked correctly — this closes that narrow gap.
## 1.2.29 - 2026-09-11
-----
* Fixed: if your shop's main currency wasn't covered by the selected NBP table (e.g. table B with
a main currency like USD or EUR), none of your other currencies got updated either, even ones
the table did cover. Fixed — the main currency's rate is now fetched automatically when needed.
## 1.2.28 - 2026-09-11
-----
* Fixed: after switching the NBP table, a currency no longer covered by the new table could keep
showing its old rate as if it were still current. It now correctly shows as unmatched instead.
## 1.2.27 - 2026-09-11
-----
* Fixed: on PrestaShop 9, the automatic-update link could be blocked by the server before it even
reached the module, so scheduled updates never actually ran. Fixed.
## 1.2.26 - 2026-09-11
-----
* Fixed: the module was still showing the wrong publisher name in the back-office modules list.
## 1.2.25 - 2026-09-09
-----
* Fixed: in some cases, saving a manual rate or running an update could report success but the
rate wouldn't actually be applied. Rate updates now always take effect reliably.
## 1.2.24 - 2026-09-09
-----
* Security: the module's own test scripts are now restricted to command-line use only, so they
can't be triggered by a direct web request on hosting setups that don't already block that on
their own (e.g. Nginx).
## 1.2.23 - 2026-09-09
-----
* Improved: the suggested automatic-update schedule now runs early every morning (including
weekends) instead of once on business-day afternoons, so orders placed any time of day always
get the correct rate, not one left over from the previous run. Explained in the settings page
and the manual.
## 1.2.22 - 2026-09-09
-----
* Changed: every update (manual or automatic) now uses the exchange rate from the last business
day before today, not today's own rate — required by Polish law for VAT invoicing, and correct
no matter what time of day the update runs. Explained on the settings page and in the manual.
## 1.2.21 - 2026-09-09
-----
* Fixed: on PrestaShop versions older than 1.7.4, syncing rates for more than one shop in a row
could mix up currency rates between shops. Fixed for every supported PrestaShop version, from
1.7.0 onward.
## 1.2.20 - 2026-09-09
-----
* Fixed: the PL/EN tabs on the in-admin manual page could stop switching depending on which
PrestaShop version/theme was rendering the page. They now work the same way everywhere.
## 1.2.19 - 2026-09-09
-----
* Fixed: technical log entries (visible under Advanced Parameters > Logs) were a mix of Polish and
English regardless of the shop's admin language. They're now consistently in English, like other
technical/developer-facing log entries.
## 1.2.18 - 2026-09-09
-----
* Fixed: in the rare case of a database hiccup while recording the invoicing audit trail, the order
could end up with its rate changed but no audit record to show for it. The two are now saved
together — if either fails, neither one does.
## 1.2.17 - 2026-09-09
-----
* New: order pages now show the real NBP rate used for invoicing right next to the rate the
customer actually paid at checkout, plus both totals converted to your shop's default currency —
no more digging through the database to see it.
## 1.2.16 - 2026-09-09
-----
* Fixed: the automatic-update link now works reliably even while the shop is in maintenance mode
or has SSL/multilingual redirects — it no longer depends on the shop's normal page routing.
## 1.2.15 - 2026-09-09
-----
* Improved: "Update now" now shows a clear warning when the selected NBP table doesn't cover any
of the shop's currencies, instead of a misleading "success" message.
## 1.2.14 - 2026-09-09
-----
* Fixed: an unused generic settings page could show a confusing, empty form — it now takes you to the real settings on the "Currency rates" page instead.
## 1.2.13 - 2026-09-09
-----
* Fixed: uninstalling the module now removes all of its data, so reinstalling starts from a completely clean state.
## 1.2.12 - 2026-09-09
-----
* Fixed: module name and description now display correctly in English store back offices.
## 1.2.11 - 2026-09-09
-----
* Fixed: the module's currency rates are no longer overwritten by PrestaShop's built-in currency updater.
## 1.2.10 - 2026-09-09
-----
* Fixed: automatic update status is now correctly reported when the feature is turned off.
## 1.2.9 - 2026-09-09
-----
* Improved: more reliable connection when fetching rates from NBP, with clearer error messages if it fails.
## 1.2.8 - 2026-09-09
-----
* Fixed: order invoicing data could be incorrectly overwritten in rare duplicate-processing cases (e.g. a payment retry).
## 1.2.7 - 2026-09-09
-----
* New: added an "A + B" NBP table option, so currencies from both NBP tables can be tracked at once.
## 1.2.6 - 2026-09-09
-----
* Fixed: excluding a currency now takes effect immediately, without waiting for the next update.
## 1.2.5 - 2026-09-09
-----
* Fixed: clearing a manual rate field now correctly reverts that currency to the NBP rate.
## 1.2.4 - 2026-09-09
-----
* Fixed: invalid manual rates are now rejected with a clear error instead of being silently ignored.
## 1.2.3 - 2026-09-09
-----
* Fixed: manual rates can now be entered using a comma as the decimal separator (e.g. "4,5").
## 1.2.2 - 2026-09-04
-----
* Fixed: excluded currencies are now fully left untouched by the module.
* Fixed: manual rates for other currencies are no longer lost when saving settings.
* Fixed: an issue that could prevent invoicing data from being saved for an order.
* Improved: failed automatic updates are now clearly reported instead of failing silently.
* New: multistore support — one automatic update now refreshes rates for every shop.
## 1.2.1 - 2026-09-04
-----
* Fixed: invoices now show the correct NBP rate date.
* Improved: checkout reliability when recording invoicing data.
* Improved: automatic update schedule now matches NBP's publication time.
## 1.2.0 - 2026-09-02
-----
* New: orders now record the real NBP rate for invoicing/accounting, separate from the rate shown to customers at checkout.
## 1.1.0 - 2026-08-19
-----
* New: set your own customer-facing exchange rate per currency, automatically converted for the storefront.
## 1.0.0 - 2026-08-18
-----
* Initial release — automatic currency rate updates from NBP, manual and automatic (cron) update options, per-currency exclusion list, PL/EN documentation.
Komentarze ()
The reviews posted on our store are not sponsored in any way. We also verify that they were added by customers who have purchased from us or guests. If you want to learn more about this topic please read our Regulations.
Moduł robi co do niego należy, ps8
Requisiti tecnici
Requisiti tecnici
- PHP 7.1 - 8.x
- Estensione server ionCube Loader
- Solo PrestaShop Importer: PHP libxml versione > 2.9.3
- Solo PrestaShop Facebook Integrator: PHP 7.2 o superiore
- Validatore IVA PrestaShop solo: PHP SOAP
Ulteriori informazioni sui requisiti tecnici nella knowledge base
Assistenza e aggiornamenti
Supporto = Aggiornamenti + HelpDesk
Ottenete 90 giorni (3 mesi) di accesso al pacchetto di supporto completo di PrestaShow.
Aggiornamenti dei moduli
I moduli ti informano degli aggiornamenti disponibili. Leggete il changelog ed eseguite un aggiornamento del modulo con un solo clic direttamente dal vostro negozio.
Pannello HelpDesk
Questo è il pannello in cui vi forniamo assistenza. Nell'HelpDesk è possibile segnalare problemi, ordinare l'installazione e gli aggiornamenti gratuiti dei moduli, nonché modifiche e lavori di sviluppo individuali.
Estendere il support o
Una volta scaduto il supporto, è possibile utilizzare il modulo senza alcuna restrizione. È possibile estendere l'accesso al supporto in qualsiasi momento, quando se ne ha bisogno.
Base di conoscenze e FAQ
Gratis per sempre
La Knowledge Base è disponibile per tutti. Vi troverete la documentazione del modulo, nonché istruzioni, video e risposte alle domande più frequenti.
Licenza
Licenza a vita per il modulo
- È possibile utilizzare il modulo senza limitazioni per 1 negozio = 1 dominio.
- È possibile utilizzare un dominio aggiuntivo, ad esempio per una copia per sviluppatori.
- Con un piccolo sovrapprezzo è possibile cambiare il dominio del modulo.
Domini aggiuntivi per Multistore
- Tutti i nostri moduli supportano PrestaShop Multistore.
- Il supporto di un numero illimitato di domini per PrestaShop Multistore richiede l'acquisto del supporto multistore per il modulo.
Modifica del codice
- Il codice del modulo relativo all'integrazione con il negozio e al design (.tpl, .css, .js) è open source e siete liberi di modificarlo.
- Il codice sorgente del modulo (.php) è criptato con ionCube e la sua modifica invalida la garanzia.
Demo
Demo - prova il modulo
- Questo modulo non dispone di un negozio demo
Non ci sono ancora voci.