IPD — Integrated Product & Distribution¶
Panoramica¶
IPD (Integrated Product & Distribution) e' l'applicazione web della Digital Irrigation Ocmis dedicata alla gestione dei listini, alla distribuzione ai Dealer e alla preparazione delle quotazioni per i Farmer (clienti finali).
L'applicazione copre l'intera catena commerciale:
| Attore | Ruolo | Dove opera |
|---|---|---|
| Vendor (Ocmis/Marani/Irtec) | Gestisce articoli, prezzi lordi di listino, traduzioni | Sezione Admin "IPD - Prodotti" / "IPD - Generale" |
| Dealer | Costruisce il Prezzo Finale Dealer e personalizza il listino Farmer | Portale IPD lato Dealer |
| Farmer | Riceve la quotazione (PDF offerta) | Documento finale |
La gestione attuale e' una versione rivista e semplificata della proposta originale di Simon Kucher, ridimensionata per renderla operativamente sostenibile dal backoffice.
Configurazione Log¶
La rotazione dei log sui server WEB*.ocmis e' basata su logrotate. La gestione dei file sotto /var/www/ocmis-web/log/nxlog/ dipende da due fattori:
| Elemento | Percorso | Funzione |
|---|---|---|
| File di configurazione generale | /etc/logrotate.conf |
Impostazioni globali |
| Configurazioni specifiche | /etc/logrotate.d/* |
Regole per singolo servizio |
| Regola nxlog | /etc/logrotate.d/rawdata-nxlog |
Rotazione log nxlog |
| Timer systemd | /usr/lib/systemd/system/logrotate.timer |
Pianificazione esecuzione |
Comandi utili¶
| Operazione | Comando |
|---|---|
| Visualizzare il timer corrente | systemctl list-timers logrotate.timer --all |
| Editare la pianificazione | vim /usr/lib/systemd/system/logrotate.timer |
Gestione Vendor¶
La gestione degli articoli e dei listini lato Vendor e' centralizzata nella sezione Admin del portale Digital Irrigation, accessibile da:
- IPD - Prodotti (anagrafica articoli e prezzi)
- IPD - Generale (gestione trasversale)
Articoli¶
Gli articoli possono essere caricati con due modalita':
| Modalita' | Descrizione |
|---|---|
| Import massivo | Tracciato XLS caricato dall'Admin |
| Gestione puntuale | Inserimento, modifica, cancellazione diretta da interfaccia Web |
Ogni articolo puo' essere:
- Associato ad 1 Prezzo Lordo di Listino per ciascuna company (Ocmis, Marani, Irtec).
- Tradotto per singolo Brand.
- Sottoposto a maggiorazione massiva per blocchi/categoria con data di decorrenza: allo scadere della data, i nuovi prezzi entrano in vigore automaticamente a sistema.
Listino¶
Il listino lega Dealer e Brand con le regole commerciali che determinano il prezzo finale.
Associazione Dealer - Brand: ogni Dealer puo' appartenere a un solo Brand.
Costruzione del Prezzo Finale Dealer (per ogni tipologia macchina: Pivot, Rotoloni, Ippodromi, Lineari):
| Elemento | Funzione | Range tipico |
|---|---|---|
| Cluster | Definisce una maggiorazione su Price List 01/24 o Price List Usa-Canada | - |
| Nazioni | Definisce lo Sconto 1 | Price List 01/24: da -61% a -43% |
| Price List Usa-Canada: da -54% a -41% | ||
| Macroarea | Non usato | - |
| Classificazione | Non usato (definirebbe Sconto 2) | - |
| Sconto 3 | Sconto applicato al Dealer da contratto | - |
| Sconto 4 / Sconto 5 | Sconti spot su specifici progetti | - |
Il risultato della catena cluster -> nazioni -> sconti 3/4/5 e' il Prezzo Finale Dealer, che e' il prezzo di acquisto del Dealer.
Gestione Dealer¶
Profili Dealer¶
| Profilo | Utenze ammesse | Descrizione |
|---|---|---|
| STD (Standard) | 1 sola utenza | Profilo base |
| PRO (Professional) | Utenza principale + "Collaboratori" | Il Dealer PRO puo' attivare sotto al proprio profilo ulteriori utenze collaboratore |
Modalita' di lavoro sui listini¶
Dalla sezione Impostazioni di IPD il Dealer sceglie come vuole costruire il prezzo da proporre al Farmer (Prezzo Lordo Farmer). La modalita' puo' essere impostata a livello di Dealer e sovrascritta per singolo Collaboratore.
Sono previste due modalita' alternative:
| Modalita' | Nome | Logica di calcolo |
|---|---|---|
| 1 | NETTO + Ricarico | Parte dal Prezzo Finale Dealer e applica un ricarico |
| 2 | LORDO | Prezzo Lordo Farmer = Prezzo Lordo di Listino (come da Vendor) |
Modalita' 1: NETTO + Ricarico¶
Il Dealer configura due parametri:
| Parametro | Valori | Descrizione |
|---|---|---|
| Tipo Ricarico | "A Valore" oppure "Ricarico %" | Definisce se il ricarico e' fisso o percentuale |
| Valore Ricarico | Numerico | Quantita' del ricarico (importo o percentuale) |
Il Prezzo Lordo Farmer e' quindi: Prezzo Finale Dealer + Ricarico.
Modalita' 2: LORDO¶
Il Prezzo Lordo Farmer coincide con il Prezzo Lordo di Listino definito dal Vendor: il Dealer non applica ricarichi in fase di costruzione listino e gestisce la marginalita' tramite gli sconti in fase di quotazione.
Quotazione ai Farmer¶
Dopo aver sviluppato il progetto, il Dealer genera la quotazione dei componenti necessari. I prezzi mostrati sono i Prezzo Lordo Farmer calcolati secondo la modalita' configurata.
Livelli di sconto applicabili¶
Il Dealer puo' applicare fino a 5 livelli di sconto su una delle seguenti entita':
| Entita' | Sconti disponibili | Disponibile per Collaboratore |
|---|---|---|
| Impostazione Generale | 5 | Si' |
| Cliente | 5 | Si' |
| Progetto | 5 | Si' |
| Macchina | 5 | Si' |
Gli sconti si applicano in cascata sul Prezzo Lordo Farmer del componente o della macchina scelta.
Output della quotazione¶
Terminata la quotazione il Dealer puo' generare automaticamente il PDF dell'offerta e inviarlo al Farmer. Il PDF riporta descrizioni, prezzi e condizioni commerciali consolidate.
Evoluzione della gestione listini¶
Versione OLD (Simon Kucher)¶
La prima versione della gestione listini su IPD era stata proposta da Simon Kucher: prevedeva un modello ampio e articolato di cluster, classificazioni e macroaree. Documentazione di riferimento: Ocmis-Gestione-Listini-Ocmis--Dealer-R3-NP.pdf (archivio ClickUp).
Versione attuale¶
Il modello e' stato fortemente ridimensionato perche' la versione originale non era sostenibile operativamente dal backoffice. Nella versione attuale:
- Macroarea e Classificazione (Sconto 2) sono presenti a sistema ma non utilizzate.
- Le dimensioni operative sono Cluster, Nazioni (Sconto 1), Sconto 3 contrattuale, Sconto 4/5 spot.
- La gestione Vendor e' concentrata sui prezzi lordi di listino per company, con maggiorazioni massive a data di decorrenza.
Note operative e problemi noti¶
Icone non visibili¶
Sono stati riscontrati casi di icone non visibili in alcune viste del portale IPD (verificati tramite ticket ClickUp). Verificare cache browser, versione del CSS distribuita e presenza dei font-icon referenziati prima di segnalare il problema come bug.
Propagazione prezzi¶
La data di decorrenza dei prezzi agisce automaticamente: non serve ripubblicare il listino, ma e' fondamentale che il backoffice controlli l'allineamento prima della data di switch per evitare ripercussioni sulle offerte in corso.
Collaboratori PRO¶
I Collaboratori di un Dealer PRO ereditano la modalita' di lavoro del Dealer ma possono averne una propria: in caso di scostamenti tra prezzi su offerte generate da utenze diverse dello stesso Dealer, verificare prima l'impostazione a livello di Collaboratore.