Leservice client et l'emballage des commandes sur votre téléphone - découvrez l'application PrestaShop Pocket 📦
- Les taux de change actuels de la Banque nationale de Pologne (NBP) dans votre boutique PrestaShop
- Taux de change actuel de la NBP sur les commandes
- Taux de change manuel – prix affiché au client
- Toutes les opérations liées aux taux de change en un seul endroit
- Automatisation en arrière-plan — un seul jeton, deux options
- Sécurité
- À qui s'adresse PrestaShop NBP ?
- Facilités pour les développeurs
- Hooks PrestaShop
- Exigences techniques
Description détaillée
Cours de change directement issus de la Banque nationale de Pologne (NBP) — flux officiel
Par défaut, PrestaShop récupère les taux de change à partir de sa propre source externe indexée sur l'euro — sans lien avec la Banque nationale de Pologne. Notre module les remplace par le tableau officiel et public des taux de change de la NBP.
Automatisation en arrière-plan — lien URL et CRON
Un seul jeton sécurisé gère la tâche CRON — il fonctionne aussi bien sur un hébergement mutualisé que sur un serveur avec accès SSH.
Taux de change manuel supplémentaire pour la conversion du prix des produits — solution prête à l’emploi pour la facturation
Indépendamment du taux de change de la NBP, vous pouvez définir un taux supplémentaire utilisé pour la conversion des prix des produits. Ce taux n’est pas visible par le client. Chaque commande en devise étrangère se voit attribuer le taux réel de la NBP en vigueur à la date d’achat.
Conformité avec la NBP
Les taux de change sont récupérés directement depuis l’API officielle et publique api.nbp.pl — tableau A (principales devises, quotidiennement) ou B (autres devises, une fois par semaine).
La devise par défaut de la boutique n’est jamais modifiée — son taux reste toujours égal à 1, conformément aux exigences de PrestaShop.
Contrôle du taux de change pour la conversion des prix
Définissez votre propre taux fixe pour n’importe quelle devise — par exemple, dans le cadre d’une promotion ou de tests — avec un aperçu de la conversion en temps réel dans le navigateur.
Le taux de référence de la Banque nationale de Pologne (NBP) continue d’être suivi en arrière-plan, quel que soit le taux défini manuellement.
Aucune intervention manuelle sur les factures
Chaque commande en devise étrangère se voit attribuer le taux de change de la NBP en vigueur à la date d’achat ou au jour ouvrable précédant la date d’achat.
Il s’agit de la seule fonctionnalité de ce type parmi les modules de taux de change pour PrestaShop.
- Lorsqu’une commande est passée en devise étrangère, le module utilise le taux de change actuel issu du taux de référence de la NBP précédemment enregistré – le processus de paiement ne se connecte pas à la NBP, de sorte qu’une panne de la NBP n’affecte pas le moment de la passation de la commande.
- Le taux de change actuel remplace le champ « conversion_rate » de la commande dans PrestaShop, utilisé par les rapports et les statistiques.
- Le montant payé par le client ne change jamais : les données sont conservées au moment de la création de la commande.
- L'ensemble complet des données est enregistré dans un tableau distinct : le taux de change issu de la page de paiement, le taux de change réel de la NBP, le tableau et la date de la NBP, ainsi que les montants bruts/nets convertis dans la devise par défaut de la boutique.
Il arrive parfois qu’une boutique souhaite afficher au client des prix différents de ceux résultant d’une conversion autre que celle du marché, à des fins de promotion, d’arrondi ou de test.
- Vous saisissez un taux identique à celui de la NBP ou tout autre taux de votre choix.
- Aperçu de la conversion en temps réel dans le navigateur, avant même d’enregistrer.
- Vider le champ rétablit la conversion automatique à partir de la NBP.
- Le taux de référence de la NBP reste visible et est mis à jour en continu à côté, quel que soit le taux saisi manuellement.
- Deux informations sont transmises à la commande : le taux de la NBP – à des fins comptables – et le taux saisi manuellement – pour le calcul des prix.
Le panneau du module affiche chaque devise de la boutique sur une seule ligne : le taux actuel de la NBP (référence), le taux défini manuellement — visible par le client — et un statut clair.
- Taux actuel: taux de la Banque nationale de Pologne (NBP) indépendant et actualisé en permanence, visible même pour les devises dont le taux est défini manuellement.
- Taux visible par le client – ce qui est effectivement transmis à la variable `conversion_rate` de PrestaShop et détermine les prix affichés sur le site.
- Statut: Par défaut, Mise à jour, Taux manuel, Exclue ou Inactive.
- Le bouton « Mettre à jour maintenant » fonctionne toujours, indépendamment de l’automatisation en arrière-plan.
- Option 1 — lien URL: pour les panneaux de type home.pl, OVH, nazwa.pl ou cron-job.org, qui lancent le cron uniquement en appelant l'adresse.
- Option 2 — crontab — ligne prête à l'emploi pour les serveurs disposant d'un accès SSH.
- Le jeton peut être annulé à tout moment et un nouveau jeton généré d’un simple clic.
Jeton aléatoire et renouvelable
Le lien vers la mise à jour automatique contient un jeton secret — sans lui, le serveur renvoie une erreur 403 Forbidden. Le jeton peut être invalidé à tout moment et un nouveau jeton peut être généré d'un simple clic dans le panneau de contrôle.
Jeton aléatoire et renouvelable
Le lien vers la mise à jour automatique contient un jeton secret — sans celui-ci, le serveur renvoie une erreur 403 Forbidden. Le jeton peut être révoqué à tout moment et un nouveau jeton peut être généré d'un simple clic dans le panneau de configuration.
Un seul point de terminaison, pas de doublons
Les deux options de cron (lien URL et crontab) mènent exactement au même emplacement sécurisé — il n’existe pas de script distinct susceptible de contourner la vérification du jeton.
Cabinets comptables et service comptable de la boutique
Des données prêtes à l'emploi et documentées pour la facturation en devise étrangère, conformes à l'obligation d'utiliser le taux de change de la NBP — sans avoir à rechercher manuellement le taux en vigueur à la date de la commande.
Boutiques de test et de développement
Contrôle total du taux de change affiché au client, indépendant du taux réel de la Banque nationale de Pologne (NBP) suivi en arrière-plan — pratique pour tester les prix et les conversions.
Facilités pour les développeurs
- Toute la logique relative aux taux de change se trouve dans des services indépendants (NbpClient, CurrencyRateUpdater, OrderRealRateApplier) — faciles à étendre et à réutiliser.
- Table dédiée ps_pshownbp_order_rate (une ligne par commande) — charge minimale sur la base de données, prête à être lue par votre propre générateur de factures.
- Couverture par des tests unitaires PHPUnit — vous pouvez apporter vos propres modifications en toute sécurité.
Hooks PrestaShop
- actionValidateOrder – enregistrement du taux de change actuel de la Banque nationale de Pologne (NBP) et des données de facturation lors de la passation de la commande.
Exigences techniques
Compatible avec les versions actuelles de PrestaShop et de PHP.
- PrestaShop : 1.7.x, 8.x et 9.x
- PHP : 7.1 ou version ultérieure
- Accès sortant HTTPS à api.nbp.pl — API publique et gratuite de la Banque nationale de Pologne (NBP), sans clé ni inscription
- Aucune dépendance externe — ne nécessite aucune bibliothèque supplémentaire
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
Exigences techniques
Exigences techniques
- PHP 7.1 - 8.x
- Extension serveur ionCube Loader
- PrestaShop Importer uniquement : PHP libxml version > 2.9.3
- PrestaShop Facebook Integrator uniquement : PHP 7.2 ou supérieur
- PrestaShop VAT Validator uniquement : PHP SOAP
Plus d'informations sur les exigences techniques dans la base de connaissances
Support et mises à jour
Support = Mises à jour + HelpDesk
Vous bénéficiez d'un accès de 90 jours (3 mois) au support complet de PrestaShow.
Mises à jour des modules
Les modules vous informeront des mises à jour disponibles. Lisez le journal des modifications et effectuez une mise à jour du module en 1 clic directement depuis votre boutique.
Panneau HelpDesk
C'est le panneau où nous vous fournissons de l'aide. Sur le HelpDesk, vous pouvez signaler des problèmes, commander l'installation et la mise à jour gratuites de modules, ainsi que des modifications et des travaux de développement individuels.
Prolonger l'assistanc e
Une fois l'assistance expirée, vous pouvez utiliser le module sans aucune restriction. Vous pouvez prolonger votre accès à l'assistance à tout moment lorsque vous en avez besoin.
Base de connaissances et FAQ
Gratuit pour toujours
La base de connaissances est accessible à tous. Vous y trouverez la documentation du module ainsi que des instructions, des vidéos et des réponses aux questions fréquemment posées.
Licence
Licence à vie pour le module
- Vous pouvez utiliser le module sans limitation pour 1 magasin = 1 domaine.
- Vous pouvez utiliser un domaine supplémentaire, par exemple pour une copie de développeur.
- Pour une somme modique, vous pouvez changer vous-même le domaine du module.
Domaines supplémentaires pour Multistore
- Tous nos modules supportent PrestaShop Multistore.
- La prise en charge d'un nombre illimité de domaines pour PrestaShop Multistore nécessite l'achat du support multistore pour le module.
Modifier le code
- Le code du module relatif à l'intégration avec la boutique et la conception (.tpl, .css, .js) est open source et vous êtes libre de le modifier.
- Le code source du module (.php) est crypté avec ionCube et sa modification annule la garantie.
Démo
Démo - tester le module
- Ce module n'a pas de boutique de démonstration
Aucune entrée pour le moment.