WDOnline – Invoice payment for woocommerce

WDOnline Invoice Payment for WooCommerce aggiunge a WooCommerce un metodo flessibile di pagamento su fattura. È progettato per negozi B2B, clienti all’ingrosso e altre attività che consentono ai clienti approvati di effettuare ordini con pagamento differito. Il plugin ti permette di controllare chi può pagare su fattura, assegnare termini di pagamento e limiti di credito, impedire ai clienti di superare il credito disponibile, gestire le informazioni sulle fatture e offrire ai clienti una panoramica dedicata delle fatture nella sezione Il mio account.

Requisiti

• WordPress 6.5 o successivo
• WooCommerce 8.0 o successivo
• PHP 7.4 o successivo
• Il cliente deve avere un account utente WordPress e aver effettuato l’accesso per utilizzare il pagamento su fattura

I clienti ospiti non possono utilizzare il pagamento su fattura, poiché il plugin necessita di un account cliente per determinare l’idoneità, i termini di pagamento, i limiti di credito e i saldi delle fatture non pagate.

Installazione

1. Vai a Plugin → Aggiungi nuovo plugin in WordPress.
2. Fai clic su Carica plugin.
3. Seleziona il file ZIP del plugin.
4. Fai clic su Installa ora.
5. Attiva WDOnline Invoice Payment for WooCommerce.
6. Vai a WD Online → WDOnline Invoice Payment for WooCommerce.

Il plugin funziona in modo indipendente e non richiede un plugin principale WD Online separato.

Schede di amministrazione

La pagina di amministrazione del plugin contiene tre schede:

• Gateway – Configura il metodo di pagamento, i termini di pagamento, i controlli sul credito, le funzionalità facoltative e le impostazioni predefinite dei ruoli.
• Invoice orders (Ordini con pagamento su fattura) – Visualizza gli ordini effettuati con pagamento su fattura.
• User roles (Ruoli utente) – Crea e gestisci i ruoli dei clienti.

La scheda User roles (Ruoli utente) è disponibile soltanto per gli amministratori.

Configurazione rapida

Per una configurazione di base:

1. Apri la scheda Gateway.
2. Attiva Enable invoice payment (Abilita il pagamento su fattura).
3. Inserisci i termini di pagamento predefiniti, ad esempio 14 o 30 giorni.
4. Imposta un limite di credito predefinito oppure inserisci 0 per un credito illimitato.
5. Decidi se abilitare il pagamento su fattura a livello globale o soltanto per determinati ruoli utente.
6. Controlla le impostazioni in Role defaults (Impostazioni predefinite dei ruoli).
7. Salva le impostazioni.
8. Modifica i singoli clienti se necessitano di termini, limiti di credito o regole di accesso differenti.

Impostazioni del gateway

Abilitare il pagamento su fattura

Questa impostazione attiva o disattiva il metodo di pagamento su fattura nella pagina di pagamento. La disattivazione del gateway non elimina gli ordini con pagamento su fattura esistenti, le impostazioni dei clienti, le fatture PDF caricate, i saldi o lo storico delle fatture.

Titolo nella pagina di pagamento

Il titolo è il nome visualizzato accanto al metodo di pagamento. Puoi utilizzare il segnaposto {days} per mostrare il termine di pagamento effettivamente applicato al cliente. Ad esempio: Fattura – {days} giorni Per un cliente con termini di pagamento a 30 giorni, il titolo verrà visualizzato come Fattura – 30 giorni.

Descrizione nella pagina di pagamento

La descrizione viene mostrata quando il cliente seleziona il pagamento su fattura. Anche qui puoi utilizzare il segnaposto {days}.

Istruzioni dell’ordine

Le istruzioni dell’ordine vengono visualizzate dopo il completamento dell’acquisto e nelle relative email dell’ordine inviate al cliente. Utilizza {days} per includere il termine di pagamento assegnato all’ordine.

Stato dell’ordine dopo il completamento dell’acquisto

Scegli lo stato WooCommerce da assegnare all’ordine dopo che viene effettuato con pagamento su fattura:

• In lavorazione
• In sospeso
• In attesa di pagamento

Lo stato dell’ordine WooCommerce e lo stato della fattura del plugin sono separati. Un ordine può quindi essere in lavorazione mentre la relativa fattura non è ancora stata creata o risulta ancora non pagata.

Ordini virtuali

Attiva questa opzione se desideri consentire ai clienti di utilizzare il pagamento su fattura per ordini contenenti soltanto prodotti virtuali.

Impostazioni globali predefinite

Le impostazioni globali predefinite si applicano quando non vengono sostituite da impostazioni specifiche del cliente o del ruolo.

Abilitazione predefinita

Attiva questa opzione per consentire per impostazione predefinita il pagamento su fattura ai clienti che hanno effettuato l’accesso. Se questa opzione è disattivata, il pagamento su fattura può comunque essere abilitato per determinati ruoli utente o singoli clienti.

Termini di pagamento predefiniti

Inserisci il numero predefinito di giorni a disposizione dei clienti per pagare a partire dalla data della fattura. I termini di pagamento vengono calcolati dalla data della fattura, non dalla data dell’ordine. Se un ordine viene effettuato il 1° settembre, fatturato il 5 settembre e prevede un termine di pagamento di 30 giorni, la scadenza sarà il 5 ottobre.

Controllo del credito

Limite di credito predefinito

Il limite di credito è l’esposizione complessiva massima consentita per un cliente per gli acquisti con pagamento su fattura.

• Inserisci un importo positivo per impostare un limite.
• Inserisci 0 per un credito illimitato.

Il plugin calcola il credito disponibile come segue: Limite di credito − saldo delle fatture non pagate = credito disponibile L’esposizione comprende gli ordini non pagati effettuati con WDOnline Invoice Payment, inclusi quelli a cui non sono ancora stati assegnati un numero o una data di fattura. Questo impedisce a un cliente di effettuare più ordini che, complessivamente, superino il limite di credito prima dell’emissione della prima fattura. Gli ordini con pagamento su fattura annullati, falliti, rimborsati e pagati vengono esclusi secondo i criteri applicabili.

Messaggio sul limite di credito nella pagina di pagamento

Questo messaggio viene visualizzato quando il pagamento su fattura non è più disponibile perché il nuovo ordine supererebbe il credito disponibile del cliente. Sono disponibili i seguenti segnaposto:

• {credit_limit} – Il limite di credito effettivamente applicato al cliente
• {available_credit} – Il credito residuo dopo aver considerato gli ordini aperti con pagamento su fattura
• {order_total} – Il totale attuale nella pagina di pagamento

Fatture scadute

Attiva Block invoice payment when the customer has overdue invoice orders (Blocca il pagamento su fattura quando il cliente ha ordini con fatture scadute) per impedire ai clienti con fatture scadute di effettuare nuovi ordini con pagamento su fattura.

Periodo di tolleranza per le fatture scadute

Il periodo di tolleranza aggiunge un determinato numero di giorni dopo la scadenza della fattura, prima che questa venga considerata scaduta. Ad esempio, una fattura con scadenza il 1° ottobre e un periodo di tolleranza di tre giorni viene considerata scaduta dopo il 4 ottobre.

Funzionalità facoltative

La sezione Features (Funzionalità) ti permette di scegliere quali parti amministrative e rivolte ai clienti del plugin devono essere attive. La disattivazione di una funzionalità ne nasconde l’interfaccia, ma non elimina le informazioni sulle fatture salvate, le impostazioni dei clienti, lo storico degli ordini, i saldi o i documenti caricati.

Profilo cliente – Pagamenti su fattura

Mostra l’abilitazione al pagamento su fattura, i termini di pagamento, i controlli sul credito e le informazioni sul saldo delle fatture quando modifichi un utente WordPress. Aggiunge inoltre informazioni sulle fatture all’elenco degli utenti.

Ordini – Stato della fattura

Aggiunge informazioni sulle scadenze delle fatture e filtri per stato della fattura all’elenco degli ordini WooCommerce.

Ordine – Gestione della fattura

Aggiunge il pannello Invoice payment (Pagamento su fattura) ai singoli ordini WooCommerce. Questo pannello viene utilizzato per gestire numeri di fattura, date, stati, date di pagamento e documenti PDF.

Bacheca – Panoramica dei pagamenti su fattura

Aggiunge un widget di riepilogo delle fatture alla bacheca principale di WordPress per gli utenti autorizzati a gestire WooCommerce.

Account cliente – Saldo e storico delle fatture

Aggiunge la sezione Invoice payments (Pagamenti su fattura) all’area Il mio account di WooCommerce del cliente. Può mostrare termini di pagamento, saldi, storico delle fatture, stati, scadenze e download protetti dei PDF. Le seguenti impostazioni dipendono da questa funzionalità e non possono essere abilitate se non è attiva:

• Account cliente – Limite di credito – Mostra o nasconde il limite di credito totale del cliente.
• Account cliente – Credito disponibile per i pagamenti su fattura – Mostra o nasconde il credito residuo disponibile del cliente.

Nascondere questi valori non disattiva il controllo del credito. Il plugin continuerà ad applicare il limite di credito del cliente nella pagina di pagamento.

Etichetta del menu Il mio account

Inserisci il testo da utilizzare per la voce di menu nell’area account del cliente. Questa impostazione modifica soltanto l’etichetta visibile e non l’URL dell’endpoint.

Titolo della pagina Il mio account

Inserisci il titolo da visualizzare nella parte superiore della pagina delle fatture del cliente.

Ordini – Fatture PDF esterne

Abilita il caricamento sicuro delle fatture PDF negli ordini con pagamento su fattura. I clienti possono scaricare le proprie fatture PDF dal proprio account dopo aver effettuato l’accesso.

Impostazioni predefinite dei ruoli

Le impostazioni predefinite dei ruoli ti permettono di assegnare condizioni diverse di pagamento su fattura ai vari ruoli utente di WordPress o WooCommerce. Per ogni ruolo puoi configurare:

• Abilitazione al pagamento su fattura
• Termini di pagamento
• Limite di credito
• Gestione delle fatture scadute

Le opzioni disponibili includono l’utilizzo delle impostazioni globali predefinite, l’abilitazione o la disabilitazione del pagamento su fattura, l’inserimento di termini di pagamento specifici per il ruolo, l’assegnazione di un limite di credito specifico e la possibilità di consentire o bloccare il pagamento su fattura in presenza di fatture scadute. L’ordine di priorità delle impostazioni è:

1. Impostazioni individuali del cliente
2. Impostazioni del ruolo utente
3. Impostazioni globali predefinite

Ad esempio, il termine di pagamento globale può essere di 14 giorni, mentre i clienti all’ingrosso ricevono 30 giorni e un cliente specifico riceve 60 giorni.

Creare ruoli cliente

Apri la scheda User roles (Ruoli utente) per creare un nuovo ruolo.

1. Inserisci un nome per il ruolo.
2. Inserisci uno slug tecnico facoltativo. Se lasci il campo vuoto, il plugin ne genera uno a partire dal nome del ruolo.
3. Seleziona un ruolo esistente da cui copiare le autorizzazioni.
4. Per i normali account cliente B2B, si consiglia di copiare il ruolo WooCommerce Customer (Cliente).
5. Crea il ruolo.

Il nuovo ruolo comparirà automaticamente in Role defaults (Impostazioni predefinite dei ruoli). La scheda Ruoli utente mostra inoltre tutti i ruoli esistenti, i relativi slug tecnici, la loro origine e il numero di utenti assegnati. Da questa pagina possono essere eliminati soltanto i ruoli creati tramite il plugin. Un ruolo non può essere eliminato mentre è assegnato a uno o più utenti. I ruoli di WordPress, WooCommerce e di terze parti sono protetti.

Impostazioni individuali del cliente

Le impostazioni individuali hanno la precedenza sulle impostazioni predefinite dei ruoli e su quelle globali. Per configurare un cliente:

1. Vai a Utenti in WordPress.
2. Modifica il cliente interessato.
3. Individua la sezione Invoice payment (Pagamento su fattura).
4. Configura i campi necessari.
5. Aggiorna l’utente.

Abilitazione al pagamento su fattura

Scegli se il cliente deve ereditare l’impostazione del ruolo o quella globale, essere abilitato esplicitamente oppure essere disabilitato esplicitamente.

Termini di pagamento

Inserisci il termine di pagamento del cliente in giorni. Lascia il campo vuoto per ereditare l’impostazione predefinita del ruolo o quella globale.

Limite di credito

Inserisci il limite di credito del cliente. Lascia il campo vuoto per ereditare l’impostazione predefinita del ruolo o quella globale, oppure inserisci 0 per un credito illimitato.

Gestione delle fatture scadute

Scegli se il cliente deve ereditare la regola predefinita, essere bloccato in presenza di fatture scadute oppure continuare a utilizzare il pagamento su fattura nonostante la presenza di fatture scadute. Quando la relativa funzionalità amministrativa è abilitata, il profilo cliente mostra anche i termini di pagamento effettivamente applicati, il saldo delle fatture non pagate, il credito disponibile e l’importo scaduto.

Comportamento nella pagina di pagamento

Il pagamento su fattura viene mostrato soltanto quando tutte le condizioni pertinenti sono soddisfatte. Il cliente deve:

• Aver effettuato l’accesso
• Essere abilitato al pagamento su fattura
• Disporre di credito sufficiente, a meno che il credito non sia illimitato
• Soddisfare le regole relative alle fatture scadute
• Soddisfare l’impostazione relativa agli ordini virtuali quando l’ordine contiene soltanto prodotti virtuali

Se il limite di credito viene superato, il pagamento su fattura viene rimosso e viene mostrato il messaggio configurato relativo al credito. Il messaggio si aggiorna quando cambia il totale dell’ordine nella pagina di pagamento. Il plugin verifica nuovamente le regole sul credito quando viene inviato l’ordine. Questa verifica lato server impedisce di completare l’acquisto con pagamento su fattura se l’account non soddisfa più le regole.

Gestire gli ordini con pagamento su fattura

Gli ordini effettuati con pagamento su fattura contengono un pannello Invoice payment (Pagamento su fattura) nell’editor degli ordini WooCommerce.

Termini di pagamento

I termini di pagamento effettivamente applicati al cliente vengono salvati nell’ordine al momento dell’acquisto. Le successive modifiche all’account del cliente non alterano gli ordini esistenti.

Numero della fattura

Inserisci il numero della fattura generato dal tuo sistema di contabilità o fatturazione.

Data della fattura

Inserisci la data di emissione della fattura. La data di scadenza viene calcolata a partire da questa data e dai termini di pagamento salvati nell’ordine.

Data di scadenza

La data di scadenza viene calcolata automaticamente. Il calcolo avviene soltanto dopo che è stata inserita una data di fattura o che l’ordine è stato contrassegnato come fatturato.

Stato della fattura

Lo stato della fattura viene gestito indipendentemente dal normale stato dell’ordine WooCommerce. A seconda delle informazioni disponibili e delle azioni eseguite, una fattura può essere indicata come:

• Non fatturata
• Fatturata
• Pagata
• Scaduta

Utilizza i pulsanti nel pannello dell’ordine per contrassegnare una fattura come emessa, pagata o non pagata.

Caricare una fattura PDF esterna

Il plugin non genera fatture. Se crei le fatture in un sistema contabile esterno, puoi caricare il PDF definitivo nell’ordine WooCommerce corrispondente.

1. Apri l’ordine.
2. Individua Invoice PDF (Fattura PDF) nel pannello Pagamento su fattura.
3. Seleziona un file PDF.
4. Fai clic su Upload PDF (Carica PDF) o Replace PDF (Sostituisci PDF).
5. Aggiorna l’ordine, se necessario.

Il nome originale del file PDF viene visualizzato sopra View current PDF (Visualizza il PDF attuale) nell’editor dell’ordine. I file PDF vengono archiviati in modo privato con nomi interni casuali. Non vengono aggiunti alla libreria multimediale pubblica di WordPress e non sono accessibili tramite un URL multimediale pubblico. I download vengono gestiti tramite WordPress e richiedono un’autorizzazione. L’accesso è limitato agli amministratori autorizzati e al cliente proprietario dell’ordine. La dimensione massima dei file PDF è di 10 MB.

Panoramica degli ordini con pagamento su fattura

Apri la scheda Invoice orders (Ordini con pagamento su fattura) per visualizzare gli ordini effettuati tramite WDOnline Invoice Payment. La panoramica include:

• Numero dell’ordine
• Data dell’ordine
• Cliente
• Stato dell’ordine WooCommerce
• Stato della fattura
• Data di scadenza
• Totale dell’ordine

Utilizza il filtro per stato dell’ordine per restringere l’elenco. Fai clic su un numero d’ordine per aprire l’editor degli ordini WooCommerce.

Area Il mio account del cliente

Quando la funzionalità relativa all’account cliente è abilitata, i clienti idonei e quelli con precedenti ordini con pagamento su fattura dispongono di una voce di menu Invoice payments (Pagamenti su fattura) nella sezione Il mio account. A seconda delle impostazioni di visualizzazione, la pagina può mostrare:

• Termini di pagamento attuali
• Saldo delle fatture non pagate
• Limite di credito
• Credito disponibile per i pagamenti su fattura
• Importo scaduto
• Storico degli ordini con pagamento su fattura
• Numero della fattura
• Data della fattura
• Data di scadenza
• Stato della fattura
• Totale dell’ordine
• Download protetto della fattura PDF

I clienti possono continuare a visualizzare lo storico degli ordini con pagamento su fattura anche se, in seguito, il pagamento su fattura viene disabilitato per i nuovi ordini sul loro account.

Panoramica dei pagamenti su fattura nella bacheca

Il widget della bacheca di WordPress offre ai gestori del negozio una rapida panoramica dell’attività relativa ai pagamenti su fattura. Le informazioni disponibili includono:

• Vendite con pagamento su fattura
• Numero di ordini con pagamento su fattura
• Numero di clienti che utilizzano il pagamento su fattura
• Valore medio degli ordini con pagamento su fattura
• Fatture pagate
• Tempo medio di pagamento
• Saldo delle fatture non pagate
• Importo scaduto
• Fatture in scadenza nei prossimi sette giorni
• Cliente con il maggior valore di acquisti con pagamento su fattura
• I cinque principali clienti per acquisti con pagamento su fattura
• Andamento del saldo non pagato, quando sono disponibili dati storici sufficienti

Le statistiche possono essere filtrate per periodi predefiniti o per un intervallo di date personalizzato. Il widget utilizza calcoli memorizzati nella cache per migliorare le prestazioni e può essere aggiornato manualmente.

Email e dettagli dell’ordine

Il plugin può mostrare istruzioni per il pagamento su fattura, termini di pagamento, date delle fatture, date di scadenza e stato della fattura nelle relative email WooCommerce inviate ai clienti e nei dettagli dell’ordine. Poiché i termini di pagamento vengono salvati nell’ordine, le informazioni rimangono coerenti anche se le impostazioni attuali dell’account del cliente vengono modificate in seguito.

Traduzione

Tutti i testi standard del plugin sono scritti in inglese e utilizzano il sistema di traduzione di WordPress. Il plugin include un modello POT ed è compatibile con:

• Pacchetti lingua di WordPress
• Loco Translate
• Procedure di traduzione standard con file PO e MO

I titoli personalizzati nella pagina di pagamento, le descrizioni, le istruzioni, le etichette dell’account, i titoli e i messaggi relativi al limite di credito possono essere modificati anche direttamente nelle impostazioni del plugin.

Compatibilità con WooCommerce

Il plugin supporta:

• Pagina di pagamento classica di WooCommerce
• Blocchi di pagamento di WooCommerce
• High-Performance Order Storage (HPOS) di WooCommerce
• Sistema tradizionale di archiviazione degli ordini WooCommerce

Diagnostica di assistenza facoltativa

Il plugin può integrarsi con WD Online Support Diagnostics quando questo plugin separato è installato. L’integrazione diagnostica è facoltativa. WDOnline Invoice Payment continua a funzionare normalmente quando il plugin di diagnostica non è installato o è disattivato. I controlli diagnostici possono aiutare a individuare problemi di configurazione senza inviare automaticamente dati di telemetria o informazioni sui clienti a servizi esterni.

Risoluzione dei problemi

Il pagamento su fattura non è visibile nella pagina di pagamento

Controlla quanto segue:

1. Il gateway è abilitato.
2. Il cliente ha effettuato l’accesso.
3. Le impostazioni del cliente, del ruolo o quelle globali consentono il pagamento su fattura.
4. L’ordine non supera il credito disponibile.
5. Il cliente non è bloccato a causa di una fattura scaduta.
6. Gli ordini virtuali sono consentiti se il carrello contiene soltanto prodotti virtuali.

Le impostazioni individuali del cliente hanno la precedenza su quelle del ruolo e su quelle globali, quindi controlla sempre il profilo utente del cliente quando il risultato non è quello previsto.

Il credito disponibile del cliente sembra errato

Controlla gli ordini aperti del cliente con pagamento su fattura. Gli ordini non pagati effettuati con questo metodo contribuiscono all’esposizione creditizia anche se non sono ancora stati assegnati loro una data o un numero di fattura. Verifica inoltre che le fatture saldate siano state contrassegnate come pagate e che eventuali rimborsi o annullamenti siano stati registrati correttamente in WooCommerce.

La data di scadenza non viene visualizzata

La data di scadenza viene calcolata soltanto dopo che è stata inserita una data di fattura o che l’ordine è stato contrassegnato come fatturato.

Il link Pagamenti su fattura nell’account restituisce una pagina 404

Aggiorna il plugin all’ultima versione. Se il problema persiste, vai a Impostazioni → Permalink in WordPress e fai clic una volta su Salva le modifiche per rigenerare le regole di riscrittura degli URL.

Non è possibile caricare un PDF

Verifica che:

• Il file selezionato sia un PDF valido
• Il file non superi i 10 MB
• La directory dei caricamenti di WordPress sia scrivibile
• La funzionalità per le fatture PDF esterne sia abilitata

Non è possibile eliminare un ruolo utente

Dalla scheda Ruoli utente possono essere eliminati soltanto i ruoli creati tramite questo plugin. Assegna tutti gli utenti a un altro ruolo prima di eliminare un ruolo creato dal plugin.

Procedura di configurazione consigliata

Per la maggior parte dei negozi B2B, il seguente approccio offre un controllo chiaro:

1. Mantieni disabilitata l’abilitazione globale al pagamento su fattura.
2. Crea o seleziona uno o più ruoli per i clienti B2B approvati.
3. Abilita il pagamento su fattura e imposta termini standard per questi ruoli.
4. Assegna i clienti approvati al ruolo appropriato.
5. Utilizza le impostazioni individuali dei clienti soltanto per le eccezioni.
6. Imposta limiti di credito realistici e abilita il blocco per le fatture scadute, quando opportuno.
7. Controlla regolarmente gli ordini con pagamento su fattura e i saldi non pagati.

Questa configurazione garantisce che il pagamento su fattura sia disponibile soltanto per i clienti approvati, consentendo comunque accordi individuali quando necessario.