Aggiornamento dei tassi di cambio NBP Pro — tassi di cambio in PrestaShop

Caratteristiche e funzionalità principali del modulo

• Dati dall'API della Banca Nazionale di Polonia: recupero delle tabelle dei cambi tramite HTTPS, con controllo della correttezza delle risposte e delle date di pubblicazione.
• Quattro varianti della fonte dei cambi: tabella A, tabelle A e B combinate, tasso di acquisto dalla tabella C oppure tasso di vendita dalla tabella C.
• Selezione delle valute incluse nell'aggiornamento: indicazione delle valute estere esistenti e attive associate al negozio selezionato in PrestaShop.
• Buffer di prezzo per ogni valuta: valore percentuale separato da 0 a 50%, considerato nel calcolo del tasso del negozio.
• Supporto di diverse valute base: conversione tramite valori di riferimento in PLN, purché la valuta base e le valute selezionate siano disponibili nella fonte utilizzata.
• Anteprima prima della conferma manuale: confronto tra il tasso attuale e quello proposto, differenza percentuale, data e numero della tabella NBP e conversione di 100 unità della valuta base.
• Validità dell'anteprima per 10 minuti: conferma da parte del dipendente che l'ha creata, dopo una nuova verifica dei cambi, delle impostazioni e della valuta base.
• Variazione massima consentita del tasso: il superamento della soglia impostata da parte di una delle valute selezionate blocca il salvataggio dell'intero pacchetto.
• Ignorare le piccole variazioni: soglia di variazione minima da 0 a 5%, che consente di lasciare il tasso invariato senza salvataggio in caso di differenze inferiori.
• Controllo dell'età della pubblicazione: limite da 1 a 30 giorni di calendario, che tiene conto delle date dei dati utilizzati per la conversione.
• Salvataggio condiviso dei cambi e della cronologia: la transazione del database e il blocco delle operazioni di questo modulo per il negozio specifico riducono il rischio di salvataggi parziali e aggiornamenti paralleli.
• Cronologia con accesso ai dettagli: data dell'operazione, modalità manuale o CRON, stato, motivo del blocco o dell'errore registrato e dettagli dell'anteprima o della modifica creata.
• Ripristino dei cambi precedenti: l'annullamento di un aggiornamento salvato è disponibile se i cambi inclusi corrispondono ancora al risultato di tale operazione.
• Automazione tramite CRON: indirizzo privato per il negozio, intervallo minimo tra i tentativi da 15 a 1440 minuti e possibilità di modificare la chiave di accesso.
• Simulazione dell'attività automatica: il parametro dry_run=1 verifica il piano di aggiornamento senza modificare i cambi del negozio.
• Aggiornamento di un sottoinsieme di valute tramite CRON: il parametro currencies limita la chiamata alle valute indicate tra quelle precedentemente abilitate nel modulo.
• Informazione sulla conversione per il cliente: un messaggio opzionale nella pagina del prodotto e nel carrello mostra il tasso effettivo del negozio per la valuta estera selezionata.
• Configurazione separata per i negozi: in multistore, impostazioni, cronologia, chiave CRON e salvataggi dei cambi riguardano il negozio specifico.
• Pannello con sei schede: Panoramica, Valute, Impostazioni, Automazione, Cronologia e Aiuto organizzano la configurazione e la gestione degli aggiornamenti.
• Periodo di conservazione della cronologia: impostazione da 7 a 365 giorni, con pulizia delle voci più vecchie dopo aggiornamenti CRON elaborati correttamente; la simulazione non avvia la pulizia.

Quali cambi NBP possono essere utilizzati nel negozio?

La fonte selezionata deve contenere la valuta base del negozio e le valute aggiornate. Il PLN costituisce il riferimento con valore 1. Le tabelle A e B possono avere date di pubblicazione diverse, perciò il modulo verifica l'età dei dati necessari per una determinata conversione.

Come funziona la conversione dei cambi e il buffer di prezzo?

PrestaShop salva il numero di unità della valuta di destinazione corrispondente a un'unità della valuta base del negozio. Il modulo calcola questo tasso come: valore della valuta base in PLN ÷ valore della valuta di destinazione in PLN × (1 + buffer percentuale ÷ 100). Il risultato viene salvato con una precisione di sei cifre decimali.

Esempio: con il PLN come valuta base e la quotazione 1 EUR = 4 PLN, il tasso del negozio è 0,25 EUR per 1 PLN. Un buffer del 2% lo aumenta a 0,255, quindi l'importo di 100 PLN convertito secondo questo tasso dà 25,50 EUR. Il buffer influisce sulla conversione standard dei prezzi, ma non è una commissione bancaria né una garanzia di margine.

Cosa ottiene il personale del negozio?

• Meno inserimento manuale dei cambi: i dati provengono dalla fonte NBP selezionata e, dopo aver aggiunto una pianificazione, gli aggiornamenti possono essere eseguiti da CRON.
• Controllo prima della modifica dei prezzi in valute estere: l'anteprima consente di valutare la conversione proposta, mentre buffer e soglie di variazione possono essere adattati alle regole del negozio.
• Accesso ai valori precedenti: i dettagli dell'aggiornamento salvato facilitano la verifica della differenza e l'eventuale ripristino dei cambi.
• Gestione multistore separata: è possibile applicare fonti, buffer e regole di automazione diverse per i singoli negozi.

Quale informazione riceve il cliente?

Dopo l'attivazione del messaggio, il cliente che utilizza una valuta estera può vedere nella scheda prodotto e nel carrello la conversione nella forma “1 unità della valuta base = tasso nella valuta del cliente”. Il messaggio informa inoltre che i prezzi utilizzano il tasso del negozio, che può includere un buffer di prezzo. L'ora dell'aggiornamento salvato e la data di pubblicazione NBP vengono mostrate quando la voce letta dall'ultima cronologia corrisponde alla valuta base attuale e al tasso del cliente; dopo il ripristino dei cambi non viene aggiunta una nuova data NBP.

Il messaggio è nascosto per la valuta base e può essere disattivato nelle impostazioni. La visualizzazione richiede che il tema metta a disposizione le posizioni supportate nella pagina del prodotto e nel carrello. Durante la visualizzazione di queste pagine, il modulo legge il tasso del negozio salvato, senza scaricare le tabelle NBP.

Come avviare l'aggiornamento dei cambi NBP in PrestaShop?

1. Seleziona il negozio e, nella scheda Valute, contrassegna le valute estere attive e imposta i relativi buffer.
2. In Impostazioni seleziona la fonte NBP, la variazione massima e minima del tasso e l'età consentita della pubblicazione.
3. Recupera l'anteprima in Panoramica e confronta i valori proposti. La sola anteprima non modifica i cambi.
4. Conferma l'anteprima corretta e verifica il risultato nella cronologia.
5. Se hai bisogno dell'automazione, attivala nella scheda Automazione e aggiungi sul server un'attività che richiami l'indirizzo CRON generato. La simulazione disponibile consente di verificare prima il risultato senza salvare i cambi.

Condizioni di funzionamento e ambito dell'aggiornamento

Il modulo è destinato a PrestaShop 1.7.x, 8.x e 9.x. Richiede PHP nella versione supportata dalla specifica edizione del negozio, l'estensione cURL, la corretta gestione dei certificati HTTPS e l'accesso del server all'API NBP. Le tabelle che memorizzano i cambi del negozio e la cronologia del modulo devono utilizzare il motore InnoDB. La valuta base deve essere attiva e avere un tasso pari a 1; il modulo non la cambia con un'altra.

Vengono aggiornati i cambi delle valute del negozio specifico, non i record dei prezzi dei prodotti né gli ordini precedenti. Prezzi speciali, importi fissi in valute estere, coupon e arrotondamenti mantengono il funzionamento nativo di PrestaShop. In un singolo negozio deve essere utilizzato un solo meccanismo di aggiornamento automatico dei cambi.

L'installazione non modifica i cambi attuali e lascia CRON disattivato. Il buffer predefinito è 0%, la variazione massima 10%, la variazione minima 0,05%, l'età consentita della pubblicazione 10 giorni, l'intervallo minimo tra i tentativi automatici 60 minuti e il periodo della cronologia 90 giorni. Il ripristino richiede una voce di cronologia conservata, cambi ancora conformi e la stessa valuta base; non serve a sovrascrivere modifiche successive.