Loyalty + Credit Revolution: configurazione e aiuto
Avvio rapido
- Carica il file ZIP di Loyalty + Credit Revolution in Modules > Module Manager e installalo.
- Apri Loyalty & Credit > Tiers & Benefits. Verifica e sostituisci la politica di sconti aziendali creata durante l’installazione prima di approvare le richieste.
- Apri Settings > Configuration > General e verifica Enable Module e New Customer Account Mode.
- In Auto-Approval, scegli se attivare l’approvazione automatica. Verifica Allow Non-VAT Keyword Approval e Trade Keywords.
- In Application Form e Display, verifica condizioni, campi di verifica e posizioni nel negozio. Lascia Consumer Cart Discount Programme ed Enable Credit Accounts disattivati finché non li hai configurati.
- Invia una richiesta di prova tramite il link generato per le richieste di account aziendale. Controllala in B2B Applications e approva l’account di prova.
- Accedi come cliente approvato e verifica il prezzo della fascia configurata, l’accesso all’azienda e i link dell’account.
- Configura il sistema di esecuzione cron condiviso e controlla i risultati delle attività prima di affidarti alla gestione pianificata di scadenze, fasce o credito.
Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.
Manuale di configurazione
Installazione e configurazione
Segui i passaggi in Avvio rapido.
Verifica della politica creata all’installazione
Apri Loyalty & Credit > Settings > Configuration. Il menu visibile include anche B2B Applications, Trade Invitations, B2B Companies, Tiers & Benefits, Privileges, la gestione dei partner e Credit Accounts & Requests.
L’installazione crea una politica di fasce aziendali. Verificala prima di accettare richieste: crea Business 20% come base per le aziende approvate, poi 22%, 24%, 26%, 28% e 30% alle soglie di fatturato al netto delle imposte di 1000, 5000, 10000, 20000 e 30000. Assegna la prima fascia aziendale come fascia iniziale del negozio. Questi sono i valori creati all’installazione, non consigli per il tuo negozio.
Seleziona il negozio interessato, imposta regole e vantaggi delle fasce e decidi se l’approvazione deve essere automatica. Gli sconti sul carrello per privati e gli account di credito sono disattivati separatamente per impostazione predefinita. Concedi ai dipendenti l’accesso solo ai controller di richieste, prezzi, credito, agevolazioni fiscali e impostazioni necessari al loro lavoro.
Configurazione: impostazioni generali
- Enable Module (
module_enabled). Attiva o disattiva le funzionalità degli account aziendali; valore predefinito:true. - Compatibility Customer Group Mirror (
trade_group_id). Associazione facoltativa a un gruppo clienti per i moduli esterni; valore predefinito:0. - New Customer Account Mode (
customer_creation_mode). Controlla le credenziali delle richieste senza accesso e la creazione dell’account. Valore predefinito:optional_setup, con password facoltativa ed email di configurazione se non viene inserita. I richiedenti che hanno effettuato l’accesso non hanno un campo password. - Enable Account Expiry (
expiry_enabled). Fa scadere gli account aziendali approvati dopo un periodo fisso; valore predefinito:false. - Validity Period (
expiry_months). Numero di mesi prima della scadenza di un account aziendale; valore predefinito:12. - Expiry Warning (
expiry_warning_days). Giorni prima della scadenza in cui viene inviata l’email di avviso; valore predefinito:30.
Compatibility Customer Group Mirror è un’associazione a un gruppo senza funzione di prezzo nelle versioni del core con gli hook di prezzo richiesti. Le versioni precedenti possono usare un gruppo predefinito isolato e gestito per la percentuale effettiva del partner. L’approvazione e il sistema prezzi del modulo determinano l’idoneità del partner. Attualmente non esiste un interruttore Set Mirror as Default Group da configurare.
Configurazione: modulo di richiesta
- Introduction Text (
form_intro_text). Testo multilingue sopra il modulo. Il testo inglese predefinito inizia con “Business Accounts are available to verified businesses” e descrive prezzi aziendali, assistenza e condizioni di pagamento. Sostituiscilo con le tue istruzioni per la richiesta. - Conclusion Text (
form_outro_text). Testo visualizzato sotto il modulo di richiesta; valore predefinito:<p>By submitting this application, you confirm that you are authorized to act on behalf of your organization and that all information provided is accurate.</p>. - Show Tier Benefits (
show_tier_benefits). Mostra i vantaggi delle fasce nel modulo di richiesta; valore predefinito:true. - Company Name (
field_company_name). Controlla il campo del nome dell’azienda nella richiesta; valore predefinito:required. - VAT Number (
field_vat_number). Controlla il campo della partita IVA nella richiesta; valore predefinito:optional. - Company Registration Number (
field_company_reg_number). Controlla il campo del numero di registrazione dell’azienda nella richiesta; valore predefinito:optional. - EORI Number (
field_eori_number). Controlla il campo del numero EORI nella richiesta; valore predefinito:hidden. - Phone (
field_phone). Controlla il campo del telefono nella richiesta; valore predefinito:optional. - Address Fields (
field_address). Controlla i campi dell’indirizzo nella richiesta; valore predefinito:optional. - Business Type (
field_business_type). Controlla il campo del tipo di attività nella richiesta; valore predefinito:optional. - Document Upload (
field_document). Controlla il campo di caricamento documenti nella richiesta; valore predefinito:optional. - Max File Size (
document_max_size). Dimensione massima del documento caricato in MB; valore predefinito:5. - Allowed Extensions (
document_extensions). Estensioni consentite per i documenti, separate da virgole; valore predefinito:pdf,jpg,jpeg,png. - Require Terms Acceptance (
terms_enabled). Richiede l’accettazione delle condizioni prima dell’invio; valore predefinito:false. - Terms Content (
terms_type). Sceglie una pagina CMS o un testo personalizzato per le condizioni; valore predefinito:cms. - CMS Page (
terms_cms_id). Pagina CMS usata per le condizioni quando è selezionata la modalità CMS; valore predefinito:0. - Custom Terms Text (
terms_custom_text). Testo delle condizioni quando è selezionata la modalità personalizzata; valore predefinito: vuoto.
Queste opzioni di visibilità si applicano alla sezione facoltativa di verifica dettagliata. Il modulo breve iniziale raccoglie nome, cognome, email per un richiedente non autenticato e nome dell’azienda. Può presentare un campo password in base a New Customer Account Mode. I richiedenti possono espandere i dettagli per la verifica della partita IVA/registrazione aziendale, i documenti, l’indirizzo e i campi facoltativi configurati. L’invio del modulo breve omette i campi di verifica dettagliata, compresi quelli contrassegnati come obbligatori. I richiedenti possono inviare il modulo breve senza compilarli.
Mantieni la directory di caricamento documenti modules/mprloyaltyrevolution/uploads/ scrivibile dal server web. Si applicano anche i limiti di caricamento PHP. Require Terms Acceptance si applica all’invio; seleziona CMS Page o inserisci Custom Terms Text prima di attivarlo.
Configurazione: approvazione automatica
- Enable Auto-Approval (
auto_approve_enabled). Consente l’approvazione automatica delle richieste che soddisfano i requisiti; valore predefinito:true. - Require Valid VAT (
auto_approve_require_vat). Richiede una verifica valida della partita IVA per l’approvazione automatica; valore predefinito:true. - Require Company Keyword Match (
auto_approve_require_keyword). Richiede una corrispondenza con una parola chiave professionale per l’approvazione automatica; valore predefinito:true. - Allow Non-VAT Keyword Approval (
auto_approve_allow_non_vat_keyword). Consente l’approvazione automatica basata solo sulle parole chiave quando non viene fornita una partita IVA; valore predefinito:true. - Trade Keywords (
auto_approve_keywords). Parole chiave confrontate con i dati aziendali inviati o ottenuti dalla verifica IVA; valore predefinito: parole chiave dei settori costruzioni/edilizia/idraulica/riscaldamento/piastrellatura/bagno in inglese e francese. - Require Document (
auto_approve_require_document). Richiede il caricamento di un documento per l’approvazione automatica; valore predefinito:false. - Limit to Countries (
auto_approve_countries). Limita l’approvazione automatica ai codici paese selezionati; valore predefinito: vuoto, quindi tutti i paesi.
Allow Non-VAT Keyword Approval è ora attivo per impostazione predefinita. Una richiesta breve senza partita IVA può quindi risultare idonea tramite le parole chiave dell’azienda se soddisfa tutte le altre condizioni attivate. Una partita IVA fornita deve comunque superare la verifica, quando richiesta. Per esaminare le richieste manualmente, disattiva Enable Auto-Approval prima di pubblicare il modulo. Un documento obbligatorio o una restrizione sui paesi può impedire l’approvazione quando il modulo breve non fornisce i dettagli necessari.
Configurazione: politica degli sconti
- Consumer Cart Discount Programme (
cart_discounts_enabled). Attiva esplicitamente il programma di sconti sul carrello per privati. Valore predefinito:false. Se disattivato, nasconde i messaggi sulle fasce del carrello per privati anche se le vecchie fasce restano memorizzate. I partner approvati sono esclusi da questo programma. - Voucher Combinability Policy (
cart_discount_combinability_policy). Controlla l’interazione degli sconti automatici con gli altri buoni; valore predefinito:manual_wins. - Allowed Stackable Vouchers (
cart_discount_stackable_rule_ids). ID dei buoni cumulabili nella modalità di cumulabilità selettiva; valore predefinito: vuoto. - Allow Customer Opt-Out (
cart_discount_allow_customer_optout). Consente ai clienti di disattivare lo sconto automatico per il carrello corrente; valore predefinito:true. - Cart Value Discount Label (
cart_discount_rule_name_pattern). Modello del nome delle regole carrello generate; valore predefinito:Cart value discount %s%%.
Attiva Consumer Cart Discount Programme solo dopo aver configurato le fasce individuali e regole carrello utilizzabili. L’installer attuale non crea il vecchio insieme di fasce per privati da Cart 5% a Cart 30%. La sola presenza di vecchie fasce memorizzate non attiva il programma per privati.
Il modello dell’etichetta accetta %s o {discount} per la percentuale. Ad esempio, usa Cart value discount {discount}%. Le regole carrello automatiche generate usano la descrizione MPR Loyalty cart value discount. Prova Voucher Combinability Policy con un buono reale; il valore predefinito manual_wins dà la precedenza al buono manuale.
Configurazione: impegni dei partner
- Enable Partner Commitments (
engagement_enabled). Attiva le righe degli impegni dei partner e la gestione degli stati; valore predefinito:false. - Commitments Intro Text (
engagement_intro_text). Testo mostrato prima delle righe degli impegni; valore predefinito:<p>Partner commitments let approved companies unlock additional rewards by supporting the partnership in specific ways.</p>. - Commitments Outro Text (
engagement_outro_text). Testo mostrato dopo le righe degli impegni; valore predefinito: vuoto. - Maximum Extra Commitment Discount (
engagement_max_extra_discount_percent). Limita lo sconto aggiunto dagli impegni; valore predefinito:3.0. - Maximum Total Partner Discount (
engagement_max_total_discount_percent). Limita lo sconto partner di base sommato ai premi per gli impegni; valore predefinito:30.0. - Enable Payment Enforcement (
engagement_payment_enforcement_enabled). Fa rispettare le regole sui metodi di pagamento previste dagli impegni; valore predefinito:false. - Enable Core Checkout JS Guard (
engagement_core_js_guard_enabled). Attiva il controllo JavaScript dei pagamenti al checkout per gli impegni; valore predefinito:true. - Payment Audit Retention (
engagement_audit_retention_days). Giorni di conservazione delle righe di audit dei pagamenti; valore predefinito:365.
Apri le schermate di gestione dei partner/impegni per definire e verificare gli impegni. Lascia il programma disattivato finché definizioni, limiti dei premi ed eventuali vincoli sui metodi di pagamento non corrispondono al tuo flusso di lavoro. Prova un metodo di pagamento idoneo e uno non idoneo prima di attivare i vincoli.
Configurazione: visualizzazione
- Button Text (
button_text). Testo multilingue del pulsante di richiesta; valore inglese predefinito:Apply for a Business Account. - Button Style (
button_style). Stile CSS del pulsante dell’account aziendale; valore predefinito:btn-primary. - Product Listing Trade Badge (
partner_listing_badge_mode). Controlla i badge dei prezzi partner negli elenchi di prodotti; valore predefinito:saving. - Navigation 2 (displayNav2) (
display_nav2). Mostra il pulsante indisplayNav2; valore predefinito:false. - Button Action (
display_nav2_mode). Per Navigation 2 (displayNav2), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayNav2; valore predefinito:link. - Top Header (displayTop) (
display_top). Mostra il pulsante indisplayTop; valore predefinito:false. - Button Action (
display_top_mode). Per Top Header (displayTop), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayTop; valore predefinito:link. - Banner (displayBanner) (
display_banner). Mostra l’avviso indisplayBanner; valore predefinito:false. - Button Action (
display_banner_mode). Per Banner (displayBanner), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayBanner; valore predefinito:link. - Product Actions (displayProductActions) (
display_product_actions). Mostra l’avviso indisplayProductActions; valore predefinito:true. - Button Action (
display_product_actions_mode). Per Product Actions (displayProductActions), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayProductActions; valore predefinito:modal. - Product Additional Info (displayProductAdditionalInfo) (
display_product_additional_info). Mostra l’avviso indisplayProductAdditionalInfo; valore predefinito:false. - Button Action (
display_product_additional_info_mode). Per Product Additional Info (displayProductAdditionalInfo), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayProductAdditionalInfo; valore predefinito:modal. - Product Buttons (displayProductButtons) (
display_product_buttons). Mostra l’avviso indisplayProductButtons; valore predefinito:false. - Button Action (
display_product_buttons_mode). Per Product Buttons (displayProductButtons), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayProductButtons; valore predefinito:modal. - Reassurance Block (displayReassurance) (
display_reassurance). Mostra l’avviso indisplayReassurance; valore predefinito:false. - Button Action (
display_reassurance_mode). Per Reassurance Block (displayReassurance), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayReassurance; valore predefinito:link. - Shopping Cart (displayShoppingCart) (
display_shopping_cart). Mostra l’avviso indisplayShoppingCart; valore predefinito:false. - Button Action (
display_shopping_cart_mode). Per Shopping Cart (displayShoppingCart), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayShoppingCart; valore predefinito:modal. - Shopping Cart Footer (displayShoppingCartFooter) (
display_shopping_cart_footer). Mostra l’avviso indisplayShoppingCartFooter; valore predefinito:false. - Button Action (
display_shopping_cart_footer_mode). Per Shopping Cart Footer (displayShoppingCartFooter), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayShoppingCartFooter; valore predefinito:modal. - Checkout Summary Top (displayCheckoutSummaryTop) (
display_checkout_summary_top). Mostra l’avviso indisplayCheckoutSummaryTop; valore predefinito:false. - Button Action (
display_checkout_summary_top_mode). Per Checkout Summary Top (displayCheckoutSummaryTop), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayCheckoutSummaryTop; valore predefinito:modal. - Left Column (displayLeftColumn) (
display_left_column). Mostra il widget indisplayLeftColumn; valore predefinito:false. - Button Action (
display_left_column_mode). Per Left Column (displayLeftColumn), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayLeftColumn; valore predefinito:link. - Right Column (displayRightColumn) (
display_right_column). Mostra il widget indisplayRightColumn; valore predefinito:false. - Button Action (
display_right_column_mode). Per Right Column (displayRightColumn), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayRightColumn; valore predefinito:link. - Homepage (displayHome) (
display_home). Mostra il banner indisplayHome; valore predefinito:false. - Button Action (
display_home_mode). Per Homepage (displayHome), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayHome; valore predefinito:link. - Footer (displayFooter) (
display_footer). Mostra il pulsante indisplayFooter; valore predefinito:false. - Button Action (
display_footer_mode). Per Footer (displayFooter), scegli un link o una finestra modale. Usa un link o una finestra modale indisplayFooter; valore predefinito:link. - Customer Account (displayCustomerAccount) (
display_customer_account). Mostra nell’area account i link alle pagine del modulo; valore predefinito:true. - Custom Hook (displayMPRLoyaltyRevolution) (
display_custom). Attiva l’output indisplayMPRLoyaltyRevolution; valore predefinito:false. - Button Action (
display_custom_mode). Per Custom Hook (displayMPRLoyaltyRevolution), scegli un link o una finestra modale. Usa un link o una finestra modale nell’hook personalizzato; valore predefinito:modal.
L’interruttore aggiuntivo Business Price Beside Add to Cart è attivo per impostazione predefinita. Controlla il prezzo aziendale/l’invito a fare richiesta accanto all’area di aggiunta al carrello. Navigation 1 non è attualmente una posizione configurabile. Ogni campo Button Action appartiene alla posizione immediatamente sopra.
Il tema deve eseguire l’hook selezionato. Per una posizione Smarty personalizzata, attiva Custom Hook (displayMPRLoyaltyRevolution) e inserisci:
{hook h="displayMPRLoyaltyRevolution"}
Configurazione: impostazioni API
- Enable HMRC API v2 (
hmrc_api_enabled). Attiva la verifica delle partite IVA britanniche tramite le credenziali HMRC; valore predefinito:false. - HMRC Client ID (
hmrc_client_id). ID client dell’applicazione HMRC; valore predefinito: vuoto. - HMRC Client Secret (
hmrc_client_secret). Segreto client dell’applicazione HMRC; valore predefinito: vuoto. - Sandbox Mode (
hmrc_sandbox_mode). Usa gli endpoint sandbox di HMRC per i test; valore predefinito:false. - Enable Companies House API (
companies_house_enabled). Attiva i controlli dei numeri di registrazione delle aziende britanniche; valore predefinito:false. - Companies House API Key (
companies_house_api_key). Chiave API di Companies House; valore predefinito: vuoto.
Inserisci le credenziali del fornitore prima di attivare i controlli HMRC o Companies House. Usa Sandbox Mode solo per la relativa configurazione di prova. Il modulo include anche la verifica delle partite IVA UE e i risultati in cache. Controlla una risposta riuscita e una risposta di servizio non disponibile nel flusso previsto.
Configurazione: email
- Application Received (
email_on_received). Invia una conferma dopo l’invio della richiesta; valore predefinito:true. - Application Approved (
email_on_approved). Invia al cliente un’email di approvazione; valore predefinito:true. - Application Rejected (
email_on_rejected). Invia al cliente un’email di rifiuto; valore predefinito:true. - Expiry Warning (
email_on_expiry_warning). Invia un avviso di scadenza dell’account aziendale; valore predefinito:true. - Admin Notification Email (
admin_email). Indirizzo email per le notifiche delle richieste; valore predefinito: vuoto, usa l’indirizzo email del negozio.
Usa le impostazioni email del negozio e prova i messaggi di ricezione, approvazione, rifiuto e scadenza delle richieste. Le variabili dei template dipendono dal tipo di email. Possono includere {shop_name}, {firstname}, {lastname}, {company_name}, {vat_number}, {application_date}, {status_url}, {tier_name}, {discount_percent}, {payment_url} e {available_credit}. Usa solo le variabili fornite al template interessato.
Configurazione: pagine aziendali
- Enable Company Pages (
auth_company_enabled). Attiva le pagine di gestione dell’azienda; valore predefinito:true. - Company Page Title (
auth_company_title). Titolo mostrato sulla pagina dell’azienda; valore predefinito:My Company. - Meta Title (
auth_company_meta_title). Titolo SEO della pagina dell’azienda; valore predefinito: vuoto. - Meta Description (
auth_company_meta_description). Descrizione SEO della pagina dell’azienda; valore predefinito: vuoto. - Enable Email Invites (
b2b_email_invite_enabled). Consente agli amministratori aziendali di invitare membri via email; valore predefinito:true. - Enable Google Places Autocomplete (
google_places_enabled). Attiva il completamento automatico degli indirizzi nei moduli aziendali; valore predefinito:false. - Google Places API Key (
google_places_api_key). Chiave API di Google Places; valore predefinito: vuoto. - Enable What3Words (
what3words_enabled). Attiva la ricerca degli indirizzi What3Words; valore predefinito:false. - What3Words API Key (
what3words_api_key). Chiave API di What3Words; valore predefinito: vuoto. - Show What3Words Map (
what3words_map_enabled). Mostra una mappa per gli indirizzi What3Words; valore predefinito:false.
I campi del profilo aziendale hanno interruttori di attivazione/disattivazione. Controlla e salva ogni interruttore. Valori precedenti come required, optional e hidden possono lasciare un campo visibile finché non ne salvi l’interruttore; queste parole non stabiliscono se il campo è obbligatorio.
| Interruttore del campo | Valore di ripiego memorizzato |
|---|---|
| Campo nome azienda | required |
| Campo partita IVA | optional |
| Campo numero di registrazione | optional |
| Campo settore | optional |
| Campo telefono | required |
| Campo sito web | hidden |
| Campo numero di dipendenti | hidden |
| Campo descrizione | hidden |
| Campo nome commerciale, campo email di fatturazione, campo LinkedIn, campo Facebook, campo Twitter/X, campo Instagram, campo tipo di attività, sezione contatti, sezione indirizzi | Nessun valore predefinito specificato |
Allow Custom Invite Message non ha un valore predefinito specificato. Impostalo secondo le tue esigenze. Gli inviti mantengono una scadenza di ripiego di sette giorni e l’oggetto multilingue “Hai ricevuto un invito a unirti a un’azienda”. Questi valori memorizzati non sono controlli separati nell’attuale modulo principale di configurazione.
Dopo l’approvazione, accedi come proprietario dell’azienda e verifica profilo, membri, ruoli, inviti, indirizzi, contatti e logo. Controlla le autorizzazioni con un secondo account membro. Il credito aziendale può essere condiviso e il sottosistema di credito supporta limiti secondari per i membri.
Configurazione: account di credito
- Enable Credit Accounts (
credit_enabled). Attiva le funzionalità degli account di credito; valore predefinito:false. - Allow credit limit requests (
credit_application_enabled). Consente ai clienti di richiedere credito dalla propria area account; valore predefinito:true. - Who can request credit (
credit_application_policy). Controlla l’idoneità alle richieste di credito; valore predefinito:partners_only. - Company request permission (
credit_application_company_permission). Stabilisce quali membri possono richiedere credito per l’azienda; valore predefinito:any_active_member. - Default requested limit (
credit_application_default_request_limit). Importo precompilato della richiesta di credito; valore predefinito:0. - Minimum request limit (
credit_application_min_limit). Importo minimo di credito che i clienti possono richiedere; valore predefinito:0. - Maximum request limit (
credit_application_max_limit). Importo massimo di credito che i clienti possono richiedere; valore predefinito:0. - Require supporting document (
credit_application_require_document). Richiede un documento per le richieste di credito; valore predefinito:false. - Default Credit Limit (
credit_default_limit). Limite di credito per i nuovi account; valore predefinito:0. - Default Coverage Ratio (
credit_coverage_ratio). Quota massima dell’ordine pagabile a credito; valore predefinito:1.0. - Default Payment Terms (
credit_payment_terms). Termine netto di pagamento in giorni per gli ordini a credito; valore predefinito:30. - Enable Interest on Overdue (
credit_interest_enabled). Aggiunge interessi ai saldi di credito scaduti; valore predefinito:false. - Interest-Free Period (
credit_interest_free_days). Giorni prima dell’inizio degli interessi; valore predefinito:0. - Monthly Interest Rate (
credit_interest_rate). Tasso di interesse mensile in percentuale; valore predefinito:0. - Interest Calculation Method (
credit_interest_method). Interessi semplici o composti; valore predefinito:simple. - Maximum Interest Cap (
credit_interest_max_percent). Interessi massimi come percentuale del capitale; valore predefinito:0. - First Reminder (
credit_first_reminder_days). Giorni prima della scadenza per il primo promemoria; valore predefinito:7. - Reminder Schedule (
credit_reminder_schedule). Giorni dei promemoria prima della scadenza, separati da virgole; valore predefinito:7,3,1. - Overdue Reminder Interval (
credit_overdue_reminder_interval). Giorni tra i solleciti per pagamenti scaduti; valore predefinito:3. - Enable Stripe Credit Payments (
credit_stripe_enabled). Consente il rimborso del credito tramite Stripe Checkout; valore predefinito:true. - Stripe Mode (
credit_stripe_mode). Modalità test o produzione di Stripe; valore predefinito:0. - Admin Test Mode (
credit_stripe_admin_test_mode). Consente ai dipendenti del back office di usare chiavi di test mentre la modalità produzione è attiva; valore predefinito:true. - Test Publishable Key (
credit_stripe_test_publishable_key). Chiave pubblicabile di test Stripe; valore predefinito: vuoto. - Test Secret Key (
credit_stripe_test_secret_key). Chiave segreta di test Stripe; valore predefinito: vuoto. - Live Publishable Key (
credit_stripe_live_publishable_key). Chiave pubblicabile di produzione Stripe; valore predefinito: vuoto. - Live Secret Key (
credit_stripe_live_secret_key). Chiave segreta di produzione Stripe; valore predefinito: vuoto. - Stripe Payment Methods (
credit_stripe_payment_method_types). Tipi di metodi di pagamento Stripe facoltativi, separati da virgole; valore predefinito: vuoto, usa le impostazioni della Dashboard Stripe. - Legacy Webhook Secret (
credit_stripe_webhook_secret). Segreto di firma webhook facoltativo per una sola modalità; valore predefinito: vuoto. - Test Webhook Secret (
credit_stripe_test_webhook_secret). Segreto di firma webhook di test Stripe; valore predefinito: vuoto. - Live Webhook Secret (
credit_stripe_live_webhook_secret). Segreto di firma webhook di produzione Stripe; valore predefinito: vuoto. - Credit Order Confirmation (
credit_email_order_placed). Invia una conferma quando viene effettuato un ordine a credito; valore predefinito:true. - Payment Reminders (
credit_email_payment_reminder). Invia promemoria per i pagamenti del credito; valore predefinito:true. - Overdue Notices (
credit_email_overdue_notice). Invia avvisi per il credito scaduto; valore predefinito:true. - Payment Received (
credit_email_payment_received). Invia una conferma dopo la ricezione di un pagamento del credito; valore predefinito:true. - Limit Changed (
credit_email_limit_changed). Avvisa i clienti quando cambiano i limiti di credito; valore predefinito:true. - Account Blocked/Unblocked (
credit_email_account_blocked). Avvisa i clienti quando gli account di credito vengono bloccati o sbloccati; valore predefinito:true.
Il credito è disattivato per impostazione predefinita. Attivarlo non approva automaticamente le richieste né assegna un importo disponibile. Esamina le richieste in Credit Accounts & Requests > Applications, assegna limite e condizioni in Accounts, poi controlla Orders, Payments, Transactions e History. Un rapporto di copertura di 1.0 consente la copertura totale; 0.5 consente la metà. Il limite predefinito è zero. I valori zero nei limiti di richiesta indicano l’assenza di un valore predefinito, minimo o massimo secondo quanto specificato nei rispettivi campi.
Default Payment Terms offre Net 7, Net 14, Net 30, Net 45, Net 60 e Net 90. Prova idoneità, credito disponibile, scadenze e blocco per insoluti prima di offrire pubblicamente il credito. I clienti possono dichiarare pagamenti offline e caricare un giustificativo; il personale conferma o rifiuta le dichiarazioni prima di considerarli ricevuti.
Stripe gestisce qui i rimborsi dei saldi di credito tramite sessioni Checkout del modulo. Non paga direttamente ogni ordine PrestaShop originale. Inizia in modalità test Stripe. Configura le chiavi di test e Test Webhook Secret, completa un rimborso e verifica che venga contabilizzato una sola volta. Poi configura le chiavi di produzione e Live Webhook Secret. Admin Test Mode consente ai dipendenti di continuare a usare le chiavi di test mentre i clienti usano la modalità produzione.
Registra l’URL webhook mostrato dal modulo, normalmente:
https://yourshop.com/business/credit/webhook
Il gestore supporta checkout.session.completed, checkout.session.expired, payment_intent.succeeded e payment_intent.payment_failed. Abbina il segreto di firma alla modalità dell’endpoint. Lasciando Stripe Payment Methods vuoto si applica la configurazione dei metodi nella Dashboard Stripe.
Configurare le fasce e verificare gli sconti
Apri Tiers & Benefits e usa le viste delle fasce B2B/B2C. Apri la pagina delle fasce dal menu; i vecchi segnalibri possono reindirizzare alla vista attuale.
- Seleziona il tipo di fasce:
tradeper gli account aziendali oppureindividualper i privati. - Crea o modifica nome, descrizione, stato attivo e ordinamento della fascia. Verifica ogni vantaggio di sconto creato all’installazione prima di approvare i clienti.
- Aggiungi regole di qualificazione e operatori. Le metriche disponibili includono valore del carrello, fatturato, numero di ordini, valore medio dell’ordine, tasso di reso, ritardi nei pagamenti, categorie/prodotti selezionati e mesi di attività.
- Aggiungi il vantaggio e il relativo valore. Traduci l’etichetta visibile del vantaggio dove viene usata.
- Verifica un cliente sotto e sopra la soglia, poi controlla i prezzi nel catalogo, nel carrello e nell’ordine. I partner approvati non partecipano al programma separato basato sul valore del carrello per i privati.
- Se attivi Consumer Cart Discount Programme, configura fasce individuali di valore del carrello con regole carrello utilizzabili, poi prova la creazione automatica delle regole, i buoni e la disattivazione da parte del cliente.
I prezzi partner dipendono dall’account aziendale approvato e dalla sua fascia effettiva. Il metodo di calcolo dei prezzi dipende dalla versione di PrestaShop.
Il widget degli sconti può mostrare una tabella delle fasce e l’avanzamento nelle pagine prodotto/carrello, al checkout o in una posizione personalizzata. Verifica anche il programma per privati e le regole carrello utilizzabili associate alle fasce, quindi td_enabled da solo non rende visibili gli sconti per privati. I seguenti valori tecnici predefiniti conservati descrivono il motore/il widget. Non sono campi separati con un proprio nome nell’attuale modulo principale Configuration:
| Chiave memorizzata | Significato e valore di ripiego nel codice |
|---|---|
tier_enabled |
Attiva la valutazione delle fasce; valore predefinito: true. |
tier_initial_tier |
Fascia facoltativa assegnata ai nuovi clienti; valore predefinito: 0. |
tier_calculation_period |
Periodo usato per le metriche delle fasce; valore predefinito: rolling_12. |
tier_new_account_min_divisor |
Divisore usato per le soglie delle fasce dei nuovi account; valore predefinito: 3. |
tier_evaluation_frequency |
Momento in cui vengono ricalcolate le fasce; valore predefinito: on_order. |
tier_immediate_upgrade |
Promuove i clienti non appena soddisfano i requisiti; valore predefinito: true. |
tier_auto_downgrade |
Consente il passaggio automatico a fasce inferiori; valore predefinito: true. |
tier_downgrade_grace_days |
Periodo di tolleranza prima del passaggio a una fascia inferiore; valore predefinito: 30. |
tier_notify_upgrade |
Invia email di passaggio a una fascia superiore; valore predefinito: true. |
tier_notify_downgrade_warning |
Invia un avviso prima del passaggio a una fascia inferiore; valore predefinito: true. |
tier_notify_downgrade_warning_days |
Giorni prima dell’avviso di passaggio a una fascia inferiore; valore predefinito: 14. |
tier_notify_downgrade |
Invia email di passaggio a una fascia inferiore; valore predefinito: true. |
tier_order_statuses |
Stati ordine facoltativi conteggiati nelle metriche delle fasce; valore predefinito: vuoto. |
tier_exclude_cancelled |
Esclude gli ordini annullati dalle metriche delle fasce; valore predefinito: true. |
tier_exclude_refunded |
Esclude gli ordini rimborsati dalle metriche delle fasce; valore predefinito: true. |
tier_deduct_partial_refunds |
Deduce i rimborsi parziali dalla spesa conteggiata per la fascia; valore predefinito: true. |
td_enabled |
Attiva il widget di sconto sul valore del carrello; valore predefinito: true. |
td_metric |
Metrica mostrata dal widget; valore predefinito: cart_value. |
td_threshold_rule |
Regola della fascia usata per le soglie del widget; valore predefinito: cart_value. |
td_tier_type |
Tipo di fasce usato dal widget; valore predefinito: individual. |
td_mode |
Modalità di visualizzazione del widget; valore predefinito: show_info. |
td_show_table |
Mostra la tabella delle fasce di sconto; valore predefinito: true. |
td_show_progress |
Mostra l’avanzamento verso lo sconto successivo; valore predefinito: true. |
td_product_page |
Mostra il widget nelle pagine prodotto; valore predefinito: true. |
td_cart_page |
Mostra il widget nella pagina del carrello; valore predefinito: true. |
td_checkout |
Mostra il widget durante il checkout; valore predefinito: false. |
td_custom_hook |
Attiva l’output del widget in una posizione personalizzata; valore predefinito: false. |
td_title |
Titolo personalizzato del widget; valore predefinito: vuoto. |
td_info_url |
URL facoltativo per i dettagli degli sconti; valore predefinito: vuoto. |
td_info_text |
Testo del link ai dettagli degli sconti; valore predefinito: vuoto. |
La politica aziendale creata all’installazione può sostituire il valore di ripiego tier_initial_tier=0 con l’ID della fascia aziendale creata. Usa l’interfaccia di gestione delle fasce per le regole e i vantaggi pubblicati.
Verificare IVA e agevolazioni fiscali
Il modulo supporta la verifica delle partite IVA, i risultati in cache, i campi di verifica delle richieste/aziende e i privilegi fiscali approvati. Le agevolazioni fiscali usano le integrazioni del gestore delle imposte del modulo, tra cui taxManager e actionTaxManager; le associazioni ai gruppi sono dati di compatibilità. Controlla le regole fiscali native del negozio insieme alla richiesta di agevolazione approvata.
La scheda VAT Checkout è assente dalla pagina di configurazione. Le seguenti impostazioni IVA al checkout e i relativi valori predefiniti sono memorizzati internamente e non possono essere modificati da quella pagina:
- Enable Checkout VAT Validation (
vies_checkout_active). Verifica le partite IVA UE nei moduli di indirizzo al checkout; valore predefinito:false. - Live Validation (Real-Time AJAX) (
vies_live_validation). Mostra un riscontro IVA in tempo reale durante la digitazione; valore predefinito:true. - Cache Validation Results (
vies_cache_hours). Ore di conservazione in cache dei risultati di verifica IVA; valore predefinito:24. - When VIES Is Unavailable (
vies_on_unavailable). Accetta o rifiuta l’invio quando VIES non è disponibile; valore predefinito:accept. - Require VAT When Company Is Filled (
vies_required_company). Richiede una partita IVA valida quando viene inserito un nome aziendale; valore predefinito:false. - Show VIES Company Info (
vies_show_company_info). Mostra i dati aziendali restituiti da VIES; valore predefinito:true. - Auto-Assign to Tax-Exempt Group (
vies_group_enabled). Aggiunge i clienti con partita IVA UE valida a un gruppo selezionato; valore predefinito:false. - Tax-Exempt Customer Group (
vies_group_id). Gruppo clienti usato quando è attiva l’assegnazione ai gruppi VIES; valore predefinito:0. - Approved Tax Privilege Group Mirror (
tax_privilege_group_id). Associazione facoltativa a un gruppo per i clienti con privilegio fiscale approvato; valore predefinito:0. - Default Tax Privilege Type (
tax_privilege_default_type). Tipo di agevolazione fiscale memorizzato sul privilegio IVA approvato; valore predefinito:vat_exemption.
Usa Privileges e il flusso delle agevolazioni fiscali per esaminare le richieste. Verifica i totali delle imposte per un cliente approvato e uno non approvato e per la destinazione interessata prima di affidarti all’agevolazione al checkout. I servizi IVA esterni possono non essere disponibili; il valore predefinito memorizzato di vies_on_unavailable è accept. Non dedurre un’agevolazione fiscale dalla sola riuscita di una verifica IVA.
Gestire le richieste e l’accesso all’azienda
Il percorso pubblico predefinito delle richieste è /business/apply. Usa i link generati per negozio/lingua. Il modulo breve iniziale è separato dai campi espandibili di verifica dettagliata.
Invia una richiesta breve di prova, poi esaminala in B2B Applications. Controlla lo stato registrato, i dettagli del tentativo, l’azienda, i risultati IVA e i documenti eventualmente forniti. Gli stati possono essere in attesa, approvato, rifiutato, revocato o scaduto. Approva o rifiuta tramite il flusso amministrativo. Controlla la pagina di stato del cliente e le email della richiesta.
Prova separatamente il percorso dettagliato se richiedi partita IVA, controlli della registrazione aziendale o documenti caricati. Prova un’email sconosciuta, un cliente esistente e un richiedente già collegato a un’azienda. Il contesto aziendale di un utente autenticato può richiedere al richiedente di completare o usare prima la propria azienda.
Usa Trade Invitations per il flusso degli inviti. Gli URL di invito contengono token privati. Prova il percorso del destinatario previsto e la scadenza senza pubblicare questi link. Dopo l’approvazione, l’account cliente può mostrare stato aziendale, azienda, agevolazione IVA, credito e link partner secondo le funzionalità attive e l’idoneità.
Pianificare scadenze, fasce e manutenzione del credito
Il modulo registra queste attività condivise:
| Attività | Pianificazione registrata |
|---|---|
| Valutare le fasce dei clienti | Ogni 3600 secondi |
| Elaborare gli account scaduti | Ogni giorno alle 06:00 |
| Elaborare le agevolazioni IVA scadute | Ogni giorno alle 06:10 |
| Inviare email di avviso della scadenza | Ogni giorno alle 09:00 |
| Manutenzione del sistema di credito | Ogni giorno alle 05:00 |
| Verificare gli impegni dei partner | Ogni 3600 secondi |
Usa la configurazione cron MPR condivisa con il relativo token condiviso. Il modulo include un sistema di esecuzione CLI:
php /var/www/html/modules/mprloyaltyrevolution/cron.php --token=YOUR_SHARED_MPR_CRON_TOKEN --max-tasks=20 --max-seconds=55 --context=cron
Un’esecuzione al minuto consente al pianificatore condiviso di avviare le attività in scadenza. Controlla i risultati e il fuso orario del server. Scadenze e avvisi degli account aziendali dipendono comunque dai rispettivi interruttori.
Sono disponibili anche URL di pianificazione precedenti e separati. I loro token sono indipendenti dal token CLI condiviso:
https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=status
https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=evaluate_tiers&limit=100
https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=process_expirations
https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=send_expiry_warnings
https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=commitments
https://yourshop.com/business/credit/cron?token=YOUR_CREDIT_TOKEN&task=all
/business/cron usa cron_token, generato se assente. /business/credit/cron richiede un credit_cron_token esistente e il credito attivo; un token mancante deve essere configurato prima di poter eseguire quell’URL. Le attività sono interest, reminders, overdue, block_overdue o all. Queste vecchie chiavi dei token non sono campi ordinari nel modulo principale. Usa gli endpoint già configurati o il sistema condiviso anziché tentare di indovinare un token.
Se mantieni un pianificatore esistente basato sugli endpoint front office, il precedente schema giornaliero/orario resta possibile con i token corretti:
0 5 * * * curl -fsS 'https://yourshop.com/business/credit/cron?token=YOUR_CREDIT_TOKEN&task=all'
0 6 * * * curl -fsS 'https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=process_expirations'
0 9 * * * curl -fsS 'https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=send_expiry_warnings'
15 * * * * curl -fsS 'https://yourshop.com/business/cron?token=YOUR_MAIN_TOKEN&action=evaluate_tiers&limit=100'
Queste chiamate eseguono direttamente le azioni richieste. Non eseguire pianificazioni duplicate senza controllare il comportamento di manutenzione risultante.
Verificare l’intero flusso dell’account
- Invia richieste di prova brevi e dettagliate. Verifica gli esiti in attesa e approvati e l’email recapitata per ogni evento.
- Accedi come cliente aziendale approvato. Verifica la fascia effettiva, i prezzi prodotto/carrello/ordine e l’accesso all’account aziendale.
- Accedi come privato. Se il programma per privati è disattivato, verifica che non venga pubblicizzato alcuno sconto sul carrello per privati. Se è attivo, verifica la regola configurata e le soglie di avanzamento.
- Prova un proprietario d’azienda e un membro con autorizzazioni limitate. Controlla inviti, indirizzi condivisi ed eventuali limiti secondari di credito dei membri.
- Se il credito è attivo, richiedi un limite, approvalo, effettua un ordine a credito consentito e controlla scadenza, importo residuo disponibile e registro contabile.
- Dichiara un rimborso offline ed esamina il giustificativo dal back office. Confermalo o rifiutalo tramite il flusso dei pagamenti. Prova separatamente un rimborso Stripe in modalità test.
- Esegui il pianificatore scelto e controlla i risultati delle attività giunte a scadenza relative a scadenze, promemoria, interessi, stati di insoluto e blocchi.
Risolvere problemi e personalizzare
- Se le richieste vengono approvate automaticamente in modo inatteso, controlla Enable Auto-Approval, Allow Non-VAT Keyword Approval e Trade Keywords. Il valore predefinito attuale consente l’approvazione per parole chiave senza partita IVA.
- Se i campi dettagliati obbligatori non compaiono nella prima schermata, espandi i dettagli di verifica. Le richieste brevi ignorano intenzionalmente questi requisiti dettagliati.
- Se manca uno sconto per privati, controlla Consumer Cart Discount Programme, le regole delle fasce individuali, le regole carrello utilizzabili sottostanti, la politica dei buoni, la disattivazione da parte del cliente e se il cliente è un partner approvato.
- Se i prezzi partner differiscono, controlla approvazione/scadenza dell’account, fascia aziendale effettiva, valore del vantaggio ed eventuali premi per impegni soggetti a un limite. Esamina il percorso di compatibilità con il core e le associazioni ai gruppi.
- Se un campo aziendale resta visibile, controlla e salva l’interruttore attuale. Le vecchie stringhe memorizzate come hidden non sono valori attuali degli interruttori.
- Se il credito non è disponibile, controlla Enable Credit Accounts, la politica di idoneità, l’approvazione dell’account, il limite, il credito disponibile, il rapporto di copertura, le condizioni, le autorizzazioni dei membri e il blocco per insoluti.
- Se un rimborso Stripe resta in attesa, controlla le chiavi e i segreti webhook specifici della modalità, la consegna degli eventi supportati e la registrazione del pagamento del credito.
- Se la manutenzione fallisce con Invalid token, distingui i token del sistema condiviso, dell’endpoint front office principale e dell’endpoint front office del credito.
- Se i caricamenti falliscono, controlla Allowed Extensions, Max File Size, i limiti di caricamento PHP e i permessi di scrittura nella directory dei caricamenti.
Puoi personalizzare .mpr-trade-discounts, .credit-account e .mpr-company-page dal foglio di stile personalizzato del tema. Controlla le posizioni attive dopo aver cambiato tema.
Disattivare o disinstallare
Usa Enable Module per le funzionalità aziendali/le richieste e gli interruttori separati di programma/credito per le rispettive aree. Esegui un backup di richieste, aziende, fasce, privilegi, impegni, account di credito, ordini, registrazioni contabili, rimborsi, giustificativi, documenti e configurazione prima della rimozione. Regolarizza le registrazioni di credito aperte attraverso il normale flusso contabile prima di eliminare i dati.
Rimuovi le chiamate pianificate obsolete. La disinstallazione prima disattiva la gestione dei prezzi partner, poi rimuove le pagine amministrative, le attività pianificate, le tabelle proprie del modulo e i metadati dei percorsi. Le tabelle condivise dell’identità cliente fornite dal pacchetto customer-auth sono contrassegnate come persistenti e vengono conservate. La disinstallazione si interrompe con un errore se la pulizia dei prezzi fallisce. Il metodo di disinstallazione non rimuove esplicitamente ogni file caricato, quindi controlla separatamente i documenti memorizzati dopo il backup. La disattivazione o disinstallazione non estingue i saldi di credito.
Schermate di riferimento






Domande
Ancora nessuna domanda su questo modulo
Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.
Problemi noti
18
Prezzi partner durante l'installazione
Installazione su PrestaShop 9
Precisione nell'allocazione del credito
Soglie in base alla valuta
Rafforzamento della sicurezza
Prezzi su PrestaShop 1.6
Sconti consumatori non configurati
Azioni interattive su PrestaShop 9
Link di richiesta localizzati
Impostazioni con valore zero
Pannelli di dettaglio dell'amministrazione
Richiesta aziendale nell'anteprima rapida
Tempistica della verifica VAT
Limiti di credito per livello
Email di approvazione degli account aziendali
Sincronizzazione del carrello
Prezzi partner non configurati
Sconti generati riutilizzabili
Richieste funzionalità
11
Implementato
Account aziendali B2B con limite di credito condiviso
Anteprima dell’approvazione automatica delle richieste B2B
Account aziendali self-service
Valutazione automatica dei livelli
Anteprima dell’approvazione
Spiegazioni dell’approvazione automatica
Percorsi localizzati per account aziendali
Impegni e vantaggi dei clienti
Inviti agli account aziendali
Richieste di cambio livello
Impostazione del pannello prezzi aziendali
Registro modifiche
v1.8.132026-05-27
- AddedPreview trade application approval
- AddedShow trade auto-approval evaluation
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedCentralize trade application submissions
- ImprovedExtract 22KB inline JS from header.tpl to external loyalty-modal.js
- FixedImprove trade VAT validation timing
- FixedPrepare cart context before loyalty sync
- FixedEnforce canonical trade apply route
- FixedPrune legacy trade apply aliases
Versioni precedenti
v1.3.02026-04-20
- AddedAdd hreflang to all remaining loyalty controllers
- AddedAdd meta and hreflang to SetPassword controller
- AddedAdd meta to Apply, hreflang to Status controller
- AddedAdd meta tags and hreflang to partner/loyalty controllers
- Addedautomatic theme detection for Classic and Hummingbird style compatibility
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedSEO handling with proper canonical URLs and meta tags on all front pages
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.1.02026-04-15
- AddedEU VAT validation for B2B company accounts with VIES real-time check
- Improvedcredit account statement view with paginated transaction history
- Fixedcredit top-up webhook not processing correctly under concurrent Stripe events
- Addedconfigurable credit expiry rules: credits older than N days auto-expire
v1.2.02026-02-09
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- AddedStripe top-up flow: customers add credit to their account via one-time payment
- Improvedtiered pricing rules: per-tier price lists apply automatically at product level
- Fixedstore credit not being deducted correctly when used alongside a cart rule
- Addedcompany account management panel: assign employees to a shared credit balance
v1.0.02025-01-31
- Initialrelease: full loyalty and store credit module for PrestaShop
- InitialStore credit accounts with manual top-up by admin or customer self-service
- InitialTiered pricing system linked to customer loyalty groups
- InitialFull transaction ledger with PDF statement export
Demo
Prova il modulo completo prima di acquistare
Acquista la licenza in seguito e mantieni le tue impostazioni.
- La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
- Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
- Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.