Vai al contenuto principale

Il multi pricelist manager

Elena Damiani
  • Aggiornato

Lo scopo di questa gestione è permettere, a partire da un listino tecnico gestito nel catalogo (a livello Layedit), la creazione di N variazioni/versioni applicando differenti coefficienti e valute. Questo è particolarmente utile, ad esempio, per la gestione di listini prezzi basati su punti, dove i prezzi devono essere modificati tramite un coefficiente e deve essere impostata la valuta desiderata.

Nota: Ora è possibile assegnare più listini commerciali a ciascun utente contemporaneamente, se previsto dalla configurazione. L'utente potrà quindi selezionare il listino desiderato tra quelli disponibili tramite un menu dedicato. Questo facilita la gestione di scenari come promozioni temporanee, listini per clienti speciali (ad esempio, Best Buyer) o liste personalizzate per esigenze commerciali specifiche.

Inoltre, questa funzionalità è integrata con la libreria degli sconti e la libreria delle maggiorazioni, che sono strumenti avanzati progettati per centralizzare e offrire maggiore flessibilità nella gestione delle variazioni di prezzo. Vedi gli articoli La libreria degli sconti e La libreria delle maggiorazioni per maggiori dettagli.

 

multiprice, mulitpricelist, vat

Vantaggi principali

  • Flessibilità: Permette di adattare rapidamente i listini a diversi mercati, clienti o scenari promozionali senza duplicare i dati di base.

  • Personalizzazione: Consente di assegnare listini specifici per paese, negozio o singolo utente, facilitando politiche commerciali differenziate.

  • Gestione centralizzata: Tutti i listini sono collegati ad un unico listino tecnico di riferimento, semplificando aggiornamenti e manutenzione dei prezzi.

  • Scalabilità: Permette di espandere facilmente il numero di listini senza impattare la struttura base del catalogo.

  • Multi-valuta e multi-coefficiente: Supporta la gestione di listini in diverse valute e con vari rapporti di prezzo, utile per contesti internazionali o strategie di vendita basate su punti.

  • Selezione del listino: L'utente può scegliere tra più listini in base al proprio profilo, ruolo o contesto di accesso.

 

Architettura e database

Il database dei listini commerciali multipli viene creato automaticamente dal backend dopo l'aggiornamento del 2025-05-29. 
Si trova nella cartella dati dell'istanza 3CADnext: _master\CommercialList.ddb.

 

Tabelle coinvolte

  1. CommercialLists: Gestione e configurazione dei listini commerciali.

  2. DiscountLibrary: Libreria e struttura degli sconti. Vedi l'articolo La libreria degli sconti per maggiori dettagli.

  3. UpchargeLibrary: Libreria e struttura delle maggiorazioni. Vedi l'articolo La libreria delle maggiorazioni per maggiori dettagli.

  4. AssocCommercialListDiscount: Associazione tra listini e sconti; gestisce la priorità di applicazione. Vedi l'articolo La libreria degli sconti per maggiori dettagli.

 

Struttura della tabella CommercialLists 

Gestisce tutti i dati relativi ai listini prezzi multipli. Ogni listino può avere una serie di informazioni aggiuntive, essere collegato a un listino tecnico, avere un rapporto di conversione dei prezzi e una valuta. Può essere assegnato a una certa entità (come un paese, un mercato, un negozio o un utente specifico). 

  • Cod: Codice identificativo del listino prezzi.

  • Des: Descrizione (compare nella lista dei listini disponibili). 

  • HiddenInfo: Informazioni aggiuntive (es. note interne). 

  • Catalog: Riferimento catalogo (codice).

  • TechPriceList: Riferimento al listino tecnico base. 

  • PriceListRatio: Rapporto di conversione prezzo rispetto al listino tecnico. 

  • Currency: Valuta del listino. 

  • EntityType: Tipo di entità assegnata (paese, negozio, utente) di cui 2 = Paese | 1 = Negozio | 0 = Utente.

  • EntityCriteria: Criterio specifico di assegnazione (es. Italia, Negozio X, Utente Y).


Uso tipico: Gestione, creazione e personalizzazione dei listini commerciali multipli per diversi mercati o clienti.

 

 

Configurazione di un listino commerciale nell'interfaccia

La configurazione del Commercial Pricelist è accessibile tramite lo strumento Supervisor in 3CADnext: 

  • Percorso: Supervisor → Catalog →  Commercial Pricelist 

  • Da qui è possibile creare, modificare e gestire tutti i listini prezzi disponibili per l'ambiente/catalogo selezionato.

Nota: È necessario selezionare il catalogo di riferimento (tramite il menu superiore) per visualizzare, filtrare e configurare i listini relativi a quel catalogo specifico. Questo è essenziale in ambienti con più cataloghi disponibili. 

 

Clicca qui per visualizzare a schermo intero.

 

La configurazione avviene tramite lo strumento 3CADnext Supervisor. Qui l'utente può creare uno o più listini commerciali definendo i seguenti parametri: 

 

Parametri configurabili

  • Cod: Codice identificativo del listino. 

  • Des: Descrizione. 

  • HiddenInfo: Informazioni aggiuntive (es. note interne). 

  • Catalog: Nome o riferimento del catalogo. 

  • TechPriceList: Riferimento al listino tecnico base. 

  • PriceListRatio: Rapporto di conversione prezzo rispetto al listino tecnico. 

  • Currency: Valuta del listino. 

  • EntityType: Tipo di entità assegnata (paese, negozio, utente, ecc.). 

  • EntityCriteria: Criterio specifico di assegnazione (es. Italia, Negozio X, Utente Y). 

Nota sull'assegnazione della valuta: Tradizionalmente la valuta era una proprietà del negozio (combinazione Paese/Lingua). Ora, invece, la valuta è una proprietà del singolo listino selezionato dall'utente.

 

Esempi pratici di configurazione

Codice Descrizione Catalogo TechPriceList Valuta EntityType EntityCriteria
CPL_SFA_EUR_2_IT_1 Listino prezzi standard Italia … … EUR 2 IT
CPL_SFA_EUR_1_IT001_1 Listino prezzi promozionale Italia … … EUR 1 IT001
CPL_SFA_EUR_0_736944_1 Listino prezzi dedicato (Best Buyer) … … EUR 0 736944
  • La lista “CPL_SFA_EUR_2_IT_1” è assegnata al paese “IT”.
  • La lista “CPL_SFA_EUR_1_IT001_1” è assegnata al negozio “IT001”.
  • La lista “CPL_SFA_EUR_0_736944_1” è assegnata all'utente “736944”.
     

Esempio di visibilità listino: 
Se l'utente “736944” accede al negozio “IT001” situato in Italia, potrà scegliere tra 3 listini diversi.

3CSV_IT_051_commercial_pricelist_and_discounts_4_sample.svg

Prospettiva dell'utente finale

L'utente finale può scegliere tra molteplici listini disponibili, tanti quanti ne sono stati assegnati secondo i criteri sopra descritti. Esempi tipici di listini disponibili: 

  • Listino prezzi standard

  • Listino prezzi promozionale

  • Listino prezzi dedicato (Best Buyer)

  • …e così via.

Questa scelta offre grande flessibilità commerciale e la possibilità di adattare la proposta economica in base al contesto di vendita o al tipo di cliente.

 

Calcolo del prezzo

Per abilitare il calcolo, il nuovo flag newPriceEngine2025 deve essere impostato in web.config. 

Nota: Per impostarlo, è necessario inviare una richiesta al reparto R&D.

 

Algoritmo di calcolo semplificato:

  1. Applicazione dei prezzi base:

    • I prezzi sono determinati dalle tabelle ARTLIST, ARTIMAGG e ARTICOLI.
       

  2. Prezzi esterni:

    • Se sono presenti prezzi esterni, questi sostituiscono i prezzi del catalogo.
       

  3. Scelta del listino commerciale:

    • La determinazione del prezzo avviene in base al listino commerciale selezionato dall'utente. Se all'utente sono stati assegnati più listini commerciali (es. a livello utente, negozio o paese), può scegliere il listino desiderato da un menu dedicato all'interno dell'interfaccia. In questo modo, l'utente ha pieno controllo e flessibilità nella scelta del listino più adatto al proprio contesto. 
       

  4. Applicazione del fattore del listino tecnico:

    • Il prezzo viene aggiornato applicando il coefficiente (PriceListRatio) fornito dal listino commerciale di riferimento. 
       

  5. Applicazione degli sconti:

    1. Gli sconti presenti nella DiscountLibrary vengono applicati secondo le priorità e le regole definite.

  6. Applicazione delle maggiorazioni:

    • Le maggiorazioni presenti nella UpchargeLibrary vengono applicati secondo le priorità e le regole definite.

       

Best practices e FAQ

  • Debugging e lettura dei log
    Il web service jRecomputePrices genera log dettagliati e strutturati per ogni ciclo di calcolo dei prezzi. Prima di validare i valori mostrati nella pagina Offerta, è essenziale consultare sia i file JSON di progetto sia i log tecnici generati dal motore di pricing. Questo approccio consente di identificare rapidamente eventuali incongruenze tra l'interfaccia utente e i dati effettivamente processati dal backend, facilitando il troubleshooting.
    Nei messaggi “Applying commercial LISTS” viene effettuato il dump del processo:

    **** Applying commercial LISTS catalog = PRICINGANDDISCOUNTSLIBRARY
    CLIST: USINGCPL_SFA_EUR_2_IT_1_1
    **** Applying commercial LISTS catalog = PRICINGANDDISCOUNTSLIBRARY
    CLIST: USINGCPL_SFA_EUR_1_IT001_0_9
    CLIST: ItemCode : S110A111 new list price 112.499997019768 factor= 0.9
    Evaluating discount Eff_S130A111_FT02_15_10 FAMILY= SER= ARTICLE=S130A111 VAR=FinishType=02
    Evaluating discount Eff_S110A111_ETA_10 FAMILY= SER= ARTICLE=S110A111 VAR=ElementType=A
    comparing ELEMENTTYPE=A
    COMPATIBLE DISCOUNT FOUND!! Eff_S110A111_ETA_10 FAMILY= SER= ARTICLE=S110A111 VAR=ElementType=A
    CLIST: NO Discounts Eff. for S110A111 ()
    CLIST: NO Discounts Max. for S110A111 ()
    ******** ECOTAXES EVALUATION Country = IT ********

     

  • Raccomandazioni su aggiornamenti/configurazioni

    Per rendere disponibile questa funzionalità, è necessario aggiornare il backend disponibile dopo il 2025‑05‑29.

 

Glossario dei termini

  • Listino Commerciale (CPL): Listino commerciale derivato da un listino tecnico, configurabile tramite coefficiente e valuta, assegnabile a paese, negozio o utente. 
     

  • TechPriceList: Listino tecnico base, gestito in Layedit, punto di riferimento per tutti i Listini Commerciali.
     

  • EntityType: Tipo di entità a cui è assegnato il listino (2 = Paese, 1 = Negozio, 0 = Utente).
     

  • EntityCriteria: Identificativo specifico per l'entità target (es. "IT" per paese, "IT001" per negozio, "736944" per utente).
     

  • Catalog: Identificativo del catalogo prodotti su cui si basa il listino. 
     

  • PriceListRatio: Coefficiente numerico applicato ai prezzi del listino tecnico per calcolare i prezzi del Listino Commerciale.
     

  • Currency: Valuta applicata al Listino Commerciale (es. EUR, USD).
     

  • DiscountLibrary: Tabella contenente la libreria centralizzata delle regole di sconto applicabili a famiglie, serie, articoli e varianti.
     

  • DiscType: Tipo di sconto gestito nella DiscountLibrary:

    • Effective: sconto effettivo applicato.

    • MaxDiscount: valore massimo di sconto consentito
       

  • Disc1–Disc5: Fino a 5 livelli progressivi (incrementali) di sconto applicati sequenzialmente.
     

  • ValidityDate: Data di validità dello sconto, formato YYYYMMDD (es. 20250101).
     

  • Variant: Combinazione di variabili e opzioni prodotto (es. VAR1=OPZ1), valida per regole di sconto specifiche. 
     

  • AssocCommercialListDiscount: Tabella di relazione che associa uno o più sconti a ciascun Listino Commerciale, determinandone la priorità.
     

  • ARTLIST / ARTIMAGG / ARTICOLI: Tabelle base contenenti i dati anagrafici degli articoli e i prezzi del listino tecnico.
     

  • Prezzi Esterni: Prezzi alternativi provenienti da fonti esterne che sovrascrivono i prezzi del catalogo se presenti.
     

  • Layedit: Strumento e ambiente per la gestione dei cataloghi tecnici.
     

  • Recompute Prices: Servizio per il ricalcolo massivo di prezzi e sconti, che genera log dettagliati.
     

  • Web.config: File di configurazione della piattaforma utilizzato per abilitare funzionalità avanzate come newPriceEngine2025.
     

  • Offer View: Pagina di visualizzazione offerte/quotazioni dove si consultano i prezzi calcolati.
     

  • Logs: Output tecnico/testuale generato durante l'elaborazione dei prezzi e l'applicazione delle regole di listino/sconto.
     

  • Project JSON: File struttura dati (JSON) che rappresenta l'intero stato e i dati di un progetto o di una quotazione.
     

  • UpchargeLibrary: Tabella contenente la libreria centralizzata delle regole di maggiorazione applicabili a famiglie, serie, articoli e varianti.

Articoli correlati