Le provvigioni per gli agenti di vendita sono uno strumento fondamentale per incentivare la forza commerciale, ma la loro gestione può risultare complessa. Questo è particolarmente vero quando i clienti pagano le fatture in modo parziale o a rate. Come si paga l’agente in questi casi? Se l’azienda corrisponde provvigioni solo a incasso avvenuto, l’agente potrebbe dover aspettare il saldo completo di una fattura. D’altra parte, pagare l’intera provvigione in anticipo espone l’azienda al rischio di insoluti.
Fortunatamente, con Odoo 18 Community e i moduli OCA (Odoo Community Association) dedicati alle provvigioni, è possibile automatizzare il calcolo e la liquidazione delle commissioni in modo flessibile. In questo articolo vedremo come i moduli OCA per le provvigioni gestiscono questo scenario, in particolare grazie alla funzionalità di provvigioni basate sui pagamenti parziali delle fatture.
Le provvigioni di vendita in Odoo Community
Odoo standard offre funzionalità limitate per le provvigioni, ma la comunità OCA mette a disposizione un pacchetto di moduli avanzati per la gestione delle provvigioni di vendita. Questi moduli permettono di definire piani provvigionali e agenti di vendita, calcolare automaticamente le commissioni su preventivi, ordini e fatture, e gestire la liquidazione periodica per ciascun agente.
Principali caratteristiche dei moduli OCA sulla gestione delle provvigioni:
- Definizione di piani provvigionali: È possibile creare diversi tipi di commissione con una percentuale fissa oppure a scaglioni variabili in base all’importo. Si può inoltre scegliere la base di calcolo: sull’importo lordo della riga (subtotal) oppure sul margine netto (utile, ossia prezzo di vendita meno costo).
- Agenti interni o esterni: Un contatto (partner) può essere contrassegnato come Agente. Nel suo profilo si assegna il tipo di provvigione applicabile e la frequenza di liquidazione (mensile, bimestrale, trimestrale, ecc.). Il modulo base gestisce agenti “esterni” (es. segnalatori o rivenditori), ma estensioni aggiuntive permettono di trattare anche agenti dipendenti interni collegati alle risorse umane.
- Assegnazione automatica sugli ordini: È possibile definire uno o più agenti di default su ciascun cliente. Quando si crea un nuovo ordine di vendita o fattura, Odoo assegna automaticamente gli agenti (e le rispettive commissioni) alle righe secondo la configurazione del cliente. L’utente può comunque modificare o integrare manualmente gli agenti su ogni singola riga tramite un’interfaccia dedicata (un’icona accanto al campo commissione).
- Calcolo commissioni al volo: In fase di conferma dell’ordine o convalida della fattura, il sistema calcola l’importo provvigionale spettante a ciascun agente in base al piano associato. Ad esempio, se abbiamo una commissione del 5% sull’importo lordo, una riga da 1.000 € genererà 50 € di provvigione per l’agente. Queste informazioni vengono registrate in apposite linee di provvigione collegate al documento.
- Provvigioni su fatture emesse o incassate: Un aspetto cruciale è decidere quando la provvigione diventa esigibile. I moduli OCA permettono di scegliere tra:
- Invoice Based – la provvigione matura quando la fattura viene emessa (confermata). L’agente ha diritto immediato alla commissione, indipendentemente dall’incasso.
- Payment Based – la provvigione matura solo a pagamento ricevuto. In caso di fattura non pagata o stornata (nota di credito), la provvigione viene annullata, garantendo un saldo provvigionale netto pari a zero.
- Liquidazione periodica delle provvigioni: Le provvigioni maturate vengono raggruppate e liquidate in base al periodo scelto per l’agente (mensile, trimestrale, ecc.). Tramite la funzione “Settle Commissions” (Liquidazione provvigioni) l’utente può generare un registro di liquidazione contenente tutte le commissioni dovute a ciascun agente in un certo intervallo temporale. Questo registro è sostanzialmente un documento riepilogativo interno dove ogni riga corrisponde a una provvigione su una fattura/ordine. È possibile quindi confermare la liquidazione e, per gli agenti esterni, persino creare in automatico una fattura fornitore intestata all’agente per pagare le commissioni dovute. In questo modo la contabilizzazione dei compensi agli agenti avviene in pochi clic e con coerenza sui registri contabili.
Esempio di configurazione di un piano provvigionale in Odoo 18, con opzioni di calcolo su importo lordo/margine e su fattura emessa/incassata
Provvigioni su pagamenti parziali delle fatture
Affrontiamo ora il caso particolare dei pagamenti parziali quando si utilizzano provvigioni a incasso (Payment Based). Senza un supporto adeguato, questo scenario genera incertezza: l’agente deve aspettare l’ultimo euro incassato per ricevere qualcosa, oppure l’azienda deve gestire manualmente acconti provvigionali ad ogni pagamento intermedio.
Il modulo aggiuntivo “Sales Commissions Based on Paid Amount” (provvigioni basate sull’importo pagato) estende Odoo 18 per risolvere elegantemente la situazione. Attivando questo modulo (e impostando nel piano provvigionale “Stato fattura: Basato su pagamenti" e “Tipo importo di pagamento: Importo pagato”), il comportamento cambia così: la provvigione viene ripartita proporzionalmente ad ogni incasso registrato. In pratica, l’agente viene pagato a tranche, in linea con quanto incassato dall’azienda dal cliente.
Vediamo un esempio concreto:
Supponiamo una fattura di 10.000 € con pagamento concordato in due rate da 5.000 € ciascuna. L’agente ha diritto a una provvigione del 10% (1.000 € in totale). Con il modulo standard “Basato sui pagamenti” tradizionale, l’agente riceverebbe i 1.000 € solo dopo l’incasso dell’ultima rata. Con “Importo pagato” invece, non appena il cliente paga la prima rata di 5.000 €, il sistema calcola che il 50% della fattura è stato incassato e quindi genera una provvigione parziale di 500 € (cioè il 10% di 5.000 €) per l’agente. L’agente può così essere subito remunerato in parte. Al momento dell’incasso della seconda rata (gli ulteriori 5.000 €), il sistema genera la seconda provvigione parziale di 500 €, raggiungendo il totale di 1.000 € dovuto.
Come viene implementato questo meccanismo? Il modulo introduce il concetto di provvigione parziale prevista e provvigione effettivamente liquidata:
- Per ogni fattura con pagamento a rate o comunque non ancora saldata, Odoo crea in automatico delle linee provvigionali “previsionali” per ciascuna scadenza di pagamento. Queste indicano quanto si prevede di pagare all’agente per ogni tranche. Nel nostro esempio, si vedrebbero due linee previsionali da 500 € ciascuna, associate alle due rate da 5.000 €.
- Man mano che registri un pagamento parziale in contabilità (che riconcilia una parte della fattura), il sistema genera una corrispondente linea di provvigione parziale effettiva. Questa rappresenta l’importo maturato in base a quel pagamento. Se l’importo pagato coincide esattamente con una scadenza, la linea effettiva sarà uguale a quella prevista. Se invece il cliente paga importi diversi dalle rate previste (es. paga solo metà di una rata), il modulo adatterà i calcoli di conseguenza. L’importo provvigionale effettivo è sempre calcolato con la formula proporzionale importo incassato * percentuale provvigione, garantendo coerenza con il totale da maturare.
- Odoo tiene collegate le linee previsionali con quelle effettive e aggiorna lo stato man mano che le provvigioni vengono liquidate. È disponibile un comodo prospetto direttamente dalla fattura o dall’elenco provvigioni dell’agente: con un clic si apre una finestra che mostra, per ogni riga di fattura, le provvigioni previste per le varie scadenze accanto alle provvigioni già maturate e liquidate.
Liquidazione e controllo: Le provvigioni parziali confluiscono nel normale processo di liquidazione periodica. La procedura di Settle Commissions rileva anche queste commissioni “a pezzetti” non ancora liquidate e le include nella liquidazione dell’agente per il periodo corrente. Ad esempio, alla fine del mese, l’agente dell’esempio sopra vedrà nel suo settlement (liquidazione) una riga da 500 € riferita alla prima rata incassata. Il mese successivo, a saldo avvenuto, un’ulteriore riga da 500 € sarà liquidata. In questo modo, ogni agente riceve ciò che gli spetta tempestivamente ad ogni incasso, senza attendere oltre e senza che l’azienda paghi in anticipo su crediti non ancora riscossi.
Da notare che il sistema gestisce anche i dettagli più complessi in automatico:
- Arrotondamenti: se una provvigione totale deve essere ripartita su tante micro-pagamenti (si pensi a un pagamento spezzettato in molte tranche), possono verificarsi piccole differenze di arrotondamento. Il modulo se ne occupa aggiustando l’ultima tranche in modo che la somma delle provvigioni parziali sia esattamente pari alla provvigione totale dovuta.
- Storni e cancellazioni: se un pagamento viene successivamente cancellato o una fattura rimborsata, le relative linee di provvigione parziali vengono automaticamente stornate o marcate come non dovute. Questo evita di lasciare provvigioni “fantasma” collegate a incassi mai definitivamente realizzati.
In sintesi, la funzionalità di provvigioni sui pagamenti parziali garantisce equità e allineamento finanziario: l’agente guadagna proporzionalmente a quanto l’azienda incassa, eliminando sia ritardi eccessivi sia rischi di pagamento anticipato. Il tutto avviene in modo trasparente e tracciato nel sistema: l’amministrazione può verificare in ogni momento lo stato delle provvigioni di un agente, quanta parte è già stata liquidata e quanta resta in sospeso in attesa di futuri incassi.
Il contributo di qtnova
La soluzione descritta è resa possibile dai moduli open source della comunità OCA, frutto del lavoro di diversi contributor. In particolare, il modulo per le provvigioni su pagato nasce da uno sviluppo iniziale di Nextev e altri membri OCA per Odoo 14, successivamente evoluto nel tempo. Qtnova ha contribuito attivamente a questo progetto effettuando la migrazione e l’aggiornamento del modulo alla versione Odoo 18, con ulteriori miglioramenti e correzioni per integrarlo al meglio nell’ecosistema aggiornato. Ringraziamo gli autori originali per la solida base fornita e siamo orgogliosi di aver collaborato con la comunità per mettere a disposizione delle aziende uno strumento così utile.
In conclusione, grazie a Odoo 18 Community e ai moduli OCA, anche scenari complessi come la gestione delle provvigioni con incassi parziali diventano automatici e sotto controllo. L’IT manager o il CEO ottengono visibilità sulle performance degli agenti e sui costi provvigionali in tempo reale, mentre gli agenti godono di un sistema equo e puntuale nei pagamenti. Se la tua azienda si trova ad affrontare sfide simili nella gestione delle provvigioni, QTNova può aiutarti ad implementare e personalizzare queste soluzioni, offrendoti competenza tecnica e conoscenza approfondita di Odoo e dei moduli comunitari. Contattaci per scoprire come ottimizzare il tuo processo provvigionale e rendere più efficiente la tua operatività commerciale.
Vuoi saperne di più? Lasciaci una mail qui sotto, ti ricontattiamo al più presto.