Atención al cliente y empaquetado de pedidos en tu móvil: descubre la app PrestaShop Pocket 📦
- Tipos de cambio actuales del NBP en tu tienda PrestaShop
- Tipo de cambio actual del NBP en los pedidos
- Tipo de cambio manual: el precio que ve el cliente
- Todas las operaciones relacionadas con los tipos de cambio en un solo lugar
- Automatización en segundo plano: un token, dos opciones
- Seguridad
- ¿A quién va dirigido PrestaShop NBP?
- Facilidades para los programadores
- Hooks de PrestaShop
- Requisitos técnicos
Descripción detallada
Tipos de cambio directamente del NBP: fuente oficial
Por defecto, PrestaShop obtiene los tipos de cambio de su propia fuente externa, referenciada al euro, que no está vinculada al Banco Nacional de Polonia. Nuestro módulo los sustituye por la tabla oficial y pública de tipos de cambio del NBP.
Automatización en segundo plano: enlace URL y CRON
Un único token seguro es compatible con CRON; funciona tanto en alojamiento compartido como en servidores con acceso SSH.
Tipo de cambio adicional y manual para el cálculo del precio del producto: una solución lista para la factura
Independientemente del tipo de cambio del NBP, puedes establecer un tipo de cambio adicional que se utilice para convertir los precios de los productos. Se trata de un tipo de cambio invisible para el cliente. Cada pedido en moneda extranjera se asocia al tipo de cambio real del NBP vigente en la fecha de la compra.
Conformidad con el NBP
Los tipos de cambio se obtienen directamente de la API oficial y pública api.nbp.pl: tabla A (divisas principales, diariamente) o B (demás, una vez a la semana).
La moneda predeterminada de la tienda nunca se modifica: su tipo de cambio siempre es 1, de acuerdo con los requisitos de PrestaShop.
Control sobre el tipo de cambio para el cálculo de precios
Establece tu propio tipo de cambio fijo para cualquier moneda —por ejemplo, para promociones o pruebas— con una vista previa de la conversión en tiempo real en el navegador.
El tipo de cambio de referencia del Banco Nacional de Polonia (NBP) se sigue monitorizando en segundo plano, independientemente del tipo de cambio manual establecido.
Cero trabajo manual con las facturas
Cada pedido en moneda extranjera se asigna el tipo de cambio del NBP correspondiente al día de la compra o al día laborable anterior a la compra.
Es la única función de este tipo entre los módulos de tipos de cambio para PrestaShop.
- Al realizar un pedido en moneda extranjera, el módulo toma el tipo de cambio actual a partir del tipo de cambio de referencia del NBP descargado previamente; el proceso de pago no se conecta con el NBP, por lo que un fallo en el NBP no afecta al momento de realizar el pedido.
- El tipo de cambio actual sobrescribe el campo «conversion_rate» del pedido en PrestaShop, utilizado por los informes y las estadísticas.
- El importe que ha pagado el cliente nunca cambia: los datos se conservan en el momento en que se crea el pedido.
- El conjunto completo de datos se envía a una tabla independiente: el tipo de cambio del proceso de pago, el tipo de cambio real del NBP, la tabla y la fecha del NBP, y los importes brutos/netos convertidos a la moneda predeterminada de la tienda.
A veces, la tienda quiere mostrar al cliente precios distintos de los que se derivan de un tipo de cambio distinto al de mercado, ya sea por motivos de promoción, redondeos o pruebas.
- Introduce el tipo de cambio igual al del NBP o cualquier otro.
- Vista previa de la conversión en tiempo real en el navegador, incluso antes de guardar.
- Al borrar el campo, se restablece el cálculo automático a partir del tipo de cambio del NBP.
- El tipo de cambio de referencia del NBP permanece visible y se actualiza constantemente al lado, independientemente del tipo de cambio manual establecido.
- Se incluyen dos datos en el pedido: el tipo de cambio del NBP —para fines contables— y el tipo de cambio manual —para el cálculo de precios—.
El panel del módulo muestra cada moneda de la tienda en una sola línea: el tipo de cambio actual del NBP (punto de referencia), el tipo de cambio establecido manualmente —visible para el cliente— y un estado claro.
- Tipo de cambio actual: el tipo de cambio del NBP, independiente y actualizado constantemente, visible incluso para las divisas con un tipo de cambio manual establecido.
- Tipo de cambio visible para el cliente: lo que realmente se envía a conversion_rate de PrestaShop y determina los precios en la tienda.
- Estado: Predeterminado, Actualizado, Tipo de cambio manual, Excluido o Inactivo.
- El botón «Actualizar ahora» funciona siempre, independientemente de la automatización en segundo plano.
- Opción 1 — enlace URL: para paneles como home.pl, OVH, nombre.pl o cron-job.org, que ejecutan el cron simplemente al acceder a la dirección.
- Opción 2 — crontab — línea lista para usar en servidores con acceso SSH.
- El token se puede invalidar en cualquier momento y generar uno nuevo con solo pulsar un botón.
Token aleatorio y regenerable
El enlace para la actualización automática contiene un token secreto; sin él, el servidor devuelve el código de error 403 Forbidden. El token se puede invalidar en cualquier momento y generar uno nuevo con solo pulsar un botón en el panel.
Token aleatorio y regenerable
El enlace para la actualización automática contiene un token secreto; sin él, el servidor devuelve el código de error 403 Forbidden. El token se puede invalidar en cualquier momento y generar uno nuevo con solo pulsar un botón en el panel.
Un único punto de acceso, sin duplicados
Ambas opciones de cron (enlace URL y crontab) conducen exactamente al mismo lugar protegido: no hay ningún script independiente que pueda eludir la verificación del token.
Asesores fiscales y contabilidad de la tienda
Datos listos y documentados para la factura en moneda extranjera, conformes con el requisito de aplicar el tipo de cambio del NBP —sin necesidad de buscar manualmente el tipo de cambio vigente el día del pedido—.
Tiendas de prueba y de desarrollo
Control total sobre el tipo de cambio que se muestra al cliente, independiente del tipo de cambio real del NBP que se sigue en segundo plano: muy práctico a la hora de probar precios y conversiones.
Facilidades para los programadores
- Toda la lógica de los tipos de cambio se encuentra en servicios independientes (NbpClient, CurrencyRateUpdater, OrderRealRateApplier), fáciles de ampliar y reutilizar.
- Tabla dedicada ps_pshownbp_order_rate (una fila por pedido): carga mínima en la base de datos, lista para ser leída por tu propio generador de facturas.
- Cubierto por pruebas unitarias de PHPUnit: introducción segura de modificaciones propias.
Hooks de PrestaShop
- actionValidateOrder: registro del tipo de cambio actual del Banco Nacional de Polonia (NBP) y de los datos de la factura al realizar el pedido.
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
Requisitos técnicos
Requisitos técnicos
- PHP 7.1 - 8.x
- Extensión de servidor ionCube Loader
Más información sobre requisitos técnicos en la base de conocimientos
Asistencia y actualizaciones
Soporte = Actualizaciones + HelpDesk
Obtendrá 90 días (3 meses) de acceso al paquete completo de soporte de PrestaShow.
Actualizaciones de módulos
Los módulos le informarán de las actualizaciones disponibles. Lea el registro de cambios y realice una actualización del módulo con 1 clic directamente desde su tienda.
Panel HelpDesk
Este es el panel donde le proporcionamos ayuda. En el HelpDesk puede informar de problemas, solicitar la instalación gratuita de módulos y actualizaciones, y encargar modificaciones y trabajos de desarrollo individuales.
Ampliar el soport e
Una vez finalizado el soporte, puede utilizar el módulo sin restricciones. Puede ampliar su acceso al soporte en cualquier momento que lo necesite.
Base de conocimientos y FAQ
Gratis para siempre
La base de conocimientos está disponible para todo el mundo. Encontrará documentación sobre el módulo, así como instrucciones, vídeos y respuestas a las preguntas más frecuentes.
Licencia
Licencia de por vida para el módulo
- Puede utilizar el módulo sin limitación para 1 tienda = 1 dominio.
- Puede utilizar un dominio adicional, por ejemplo, para una copia de desarrollador.
- Por un módico precio puede cambiar usted mismo el dominio para el módulo.
Dominios adicionales para Multitienda
- Todos nuestros módulos son compatibles con PrestaShop Multitienda.
- El soporte para un número ilimitado de dominios para PrestaShop Multitienda requiere la compra del soporte multitienda para el módulo.
Modificación del código
- El código del módulo relacionado con la integración con la tienda y el diseño (.tpl, .css, .js) es de código abierto y puede modificarlo libremente.
- El código fuente del módulo (.php) está encriptado con ionCube y modificarlo anulará la garantía.
Demo
Demo - probar el módulo
- Este módulo no tiene tienda demo
Todavía no hay entradas.