Pricing engine

QuoteNode usa un motore di pricing deterministico che garantisce calcoli riproducibili e auditabili. Ogni prezzo, sconto e imposta segue un ordine preciso di valutazione.

Ordine di calcolo

Il motore elabora i prezzi in questa sequenza:

1. prezzo unitario di riga
2. valutazione di pricing rules
3. moltiplicazione per quantita
4. sconto di riga
5. IVA di riga
6. lordo di riga
7. subtotal
8. sconto a livello offerta
9. shipping
10. totale netto
11. totale IVA
12. totale lordo

Pricing rules

Le pricing rules consentono aggiustamenti automatici in base alla relazione col cliente.

Target delle regole

• per cliente specifico
• per gruppo cliente

Scope delle regole

• tutti i prodotti
• uno specifico gruppo prodotto

Tipi di regola

• sconto percentuale
• markup percentuale
• sconto a importo fisso
• markup a importo fisso

Priorita e conflitti

Quando piu regole corrispondono:

1. vengono ordinate per priorita
2. vince quella con priorita piu alta
3. le regole non si accumulano

Multivaluta

QuoteNode supporta offerte in qualunque valuta configurata:

• valuta base del tenant
• valuta dell’offerta
• tasso di cambio tra le due

I tassi usati vengono salvati nello snapshot offerta per garantire coerenza storica e reporting corretto.

Ruoli dei tassi di cambio

• valuta base del tenant per reporting
• valuta dell’offerta per il documento cliente
• tasso memorizzato nello snapshot per audit

Gestione IVA

I gruppi IVA definiscono le aliquote disponibili, come 23%, 8%, 5%, 0% ed esente. L’IVA viene calcolata per riga, non come percentuale piatta sul totale, cosi da supportare offerte con aliquote miste.

Modalita di visualizzazione prezzo

Ogni offerta puo usare modalita NET, GROSS oppure NET + VAT + GROSS, che influenzano sia PDF sia pagina pubblica.

Sconti

QuoteNode supporta:

• sconti di riga
• sconti globali di offerta
• modalita di visualizzazione sconto differenti nei template

Sconti di riga

Gli sconti di riga possono essere percentuali o a importo fisso e vengono applicati prima del calcolo IVA della riga.

Sconto globale

Lo sconto globale viene applicato dopo la somma delle righe ma prima di spedizione e totali finali.

Arrotondamento

Tutti i calcoli monetari usano un criterio di arrotondamento consistente, applicato a livello riga, IVA e totale, in modo da mantenere allineati i subtotali con il totale finale.

Totali memorizzati

I totali calcolati vengono persistiti in una tabella denormalizzata offer_totals per query rapide, audit e accuratezza storica.

Esempi operativi

Un cliente VIP puo ricevere uno sconto percentuale globale, mentre un cliente collegato a un gruppo specifico puo ereditare una regola applicata solo a un certo gruppo prodotto.

Impatto sui PDF

Le modalita di visualizzazione prezzo e sconto influenzano direttamente la leggibilita dei PDF e il modo in cui il cliente interpreta il documento.

Impatto sui link pubblici

La stessa logica di prezzo deve restare coerente anche nella pagina pubblica dell’offerta, evitando disallineamenti tra builder interno, PDF e output cliente.

Ruolo dei listini acquisto

Quando l’offerta nasce da listini acquisto, il sistema deve mantenere leggibile il rapporto tra costo sorgente, markup e prezzo commerciale finale.

Accuratezza per audit e report

Il fatto che i totali vengano memorizzati e snapshotati rende possibile confrontare i risultati calcolati con i report storici, con i PDF gia inviati e con la timeline delle offerte senza dover ricostruire a posteriori regole e contesto operativo.

Perche la determinazione conta

Un motore di prezzo deterministico riduce conflitti interni, evita discrepanze tra canali di output e rende difendibile il valore finale presentato al cliente.