AL Hierarchical Price List - Guida utente

1. Concetti in un minuto

• Una struttura di listino è un nodo della gerarchia. Esiste per un gruppo prezzi cliente, e i prezzi di quel gruppo sono i prezzi del nodo.
• Una gerarchia mette le strutture una sotto l'altra: un nodo eredita dal padre, il padre dal proprio padre, e così via fino alla radice. È quello che rende un listino un affinamento di un altro invece di una sua copia.
• Una gerarchia va certificata prima di essere usata. Finché è aperta si può modificare e non risolve i prezzi; una volta certificata risolve i prezzi e non si può più modificare finché non viene riaperta.
• L'assegnazione al cliente collega un cliente a un nodo, per un periodo. Un cliente ha un'assegnazione per periodo, e vale quella in vigore alla data del documento.
• Risolvere un prezzo vuol dire: cercare il prezzo sul nodo del cliente, poi sui suoi antenati fino alla radice, e fermarsi al primo che risponde.
• L'app funziona su tutti e due i motori prezzi di Business Central: sul calcolo prezzi esteso aggiunge le origini prezzo della gerarchia alla ricerca standard, sul motore precedente percorre la gerarchia da sola.

2. Prerequisiti

• Microsoft Dynamics 365 Business Central, versione 28.0 o superiore, online (SaaS) e on-premises. AppSource copre gli ambienti online; per l'on-premises la distribuzione e l'installazione sono dirette di AppLibra, tramite l'AppLibra License Manager.
• Le dipendenze installate: AL License and Trial Management, AL Foundation App, AL Role Center.
• Permessi: assegnare ALPHPL-USER per l'uso quotidiano, cioè leggere le gerarchie e assegnare un listino a un cliente, oppure ALPHPL-ADMIN, che lo include e aggiunge il setup dell'app, la cancellazione delle assegnazioni ai clienti e la pagina dove le gerarchie si costruiscono e si certificano. Costruire una gerarchia è un atto da amministratore: una gerarchia aperta non risolve prezzi, e i documenti di tutti i clienti appesi a lei si fermano finché non viene certificata di nuovo. La divisione dei due ruoli dice chi dovrebbe costruirle, ma non lo impedisce a chi ha solo il ruolo operativo: il dettaglio è nel capitolo di risoluzione problemi.
• Gruppi prezzi cliente: le gerarchie si costruiscono su di loro, quindi conviene averli già pronti, o crearli strada facendo.

3. Setup

3.1 Attivare la licenza

Aprire Setup listino prezzi (HPL) e scegliere Aggiungi licenza. La prova parte al primo salvataggio del setup; la stessa azione rilegge la licenza dopo che è stata acquistata o rinnovata.

3.2 Setup listino prezzi (HPL)

Un solo interruttore, Crea la testata listino su nuovo gruppo prezzi cliente:

• acceso: ogni nuovo gruppo prezzi cliente riceve subito il suo listino di vendita, così il gruppo si può usare come nodo di una gerarchia senza passare prima dai listini. Ha effetto solo con il calcolo prezzi esteso di Business Central attivo;
• spento: non viene creato niente, e chi vuole il listino di un gruppo lo fa a mano.

3.3 Le strutture di listino

Una struttura viene creata per ogni gruppo prezzi cliente, quindi l'elenco delle strutture segue l'elenco dei gruppi. Si apre da Strutture listini prezzi (HPL), con il gruppo da cui ognuna legge i prezzi.

3.4 Costruire e certificare la gerarchia

Aprire Setup gerarchia listini prezzi (HPL) e scegliere la gerarchia, o crearne una nuova. Questa pagina sta in ALPHPL-ADMIN, che indica chi dovrebbe usarla e non impedisce ad altri di aprirla, come spiega il capitolo di risoluzione problemi. Poi:

1. Aggiungere il nodo radice con Ottieni strutture listino, scegliendo la struttura del listino più generale.
2. Selezionare la radice e aggiungere i figli con la stessa azione, uno per ogni listino che affina quello generale. Il rientro mostra chi eredita da chi.
3. Ripetere sui figli quanto serve alla politica commerciale: il numero di livelli non ha limite.
4. Scegliere Certifica. Da qui in avanti la gerarchia risolve i prezzi e non si può modificare finché non viene riaperta.

Ogni nodo si controlla mentre lo si costruisce: Listino prezzi apre i prezzi di vendita della sua struttura, Mostra origine apre il gruppo prezzi cliente che c'è dietro, Clienti mostra chi finisce su quel nodo.

4. Assegnare un listino a un cliente

Due strade, lo stesso risultato:

• dal cliente: scheda cliente, gruppo Listini prezzi gerarchici (HPL), azione Setup listini prezzi cliente (HPL);
• dall'elenco: Setup listini prezzi cliente (HPL) da Tell Me o dal role center.

Sulla riga si compilano la data di inizio, la data di fine se l'assegnazione scade, e si sceglie il nodo con il drill down su Listino prezzi. Regole da sapere:

• un'assegnazione ha sempre una data di inizio;
• la data di fine può restare vuota, e allora l'assegnazione non scade;
• la data di fine deve cadere nello stesso anno della data di inizio;
• un cliente che ha un'assegnazione di listino non tiene anche un gruppo prezzi cliente sulla scheda: l'app rifiuta l'uno quando c'è l'altro, perché è la gerarchia a decidere il gruppo. Il rifiuto avviene sulla scheda: un gruppo scritto da codice, da un'importazione o da un'altra app, non viene fermato, perché il controllo si aggancia al campo che si sta modificando e fuori da una pagina non ce n'è uno. Se la combinazione si crea lo stesso, l'app non ferma il documento, perché per lei il prezzo non è ambiguo e arriva dalla gerarchia: lo dice con un avviso mentre risolve il prezzo, nominando il cliente e il gruppo, con l'azione che apre il cliente. L'avviso compare una volta per cliente e non una per riga. Sul cliente si lascia uno dei due.

5. Come viene risolto il prezzo

Su un documento di vendita, per il cliente del documento e alla data del documento (la data registrazione su fattura e nota di credito, la data ordine negli altri casi):

1. L'app cerca l'assegnazione in vigore a quella data. Se non ce n'è nessuna non fa niente, e il motore standard lavora come sempre.
2. Percorre la gerarchia dal nodo dell'assegnazione fino alla radice.
3. Con il calcolo prezzi esteso aggiunge il gruppo prezzi cliente di ogni nodo alle origini della ricerca standard, dando la priorità più alta al nodo più specifico; poi è il motore standard a scegliere il prezzo.
4. Con il motore precedente percorre da sola lo stesso cammino e si ferma al primo prezzo che trova.

I prezzi restano dove sono sempre stati, nei listini di vendita dei gruppi: l'app non li copia e non li calcola.

Una precedenza da sapere, se è installata anche AL Advanced Discounts and Pricing: un prezzo unitario forzato a mano sulla riga vince sulla gerarchia. Con il suo interruttore di setup acceso e un prezzo forzato sulla riga di vendita, la ricerca prezzo standard viene saltata, quindi questa app non viene nemmeno interrogata. È voluto, ed è il verso giusto: un prezzo concordato a mano non è un listino.

6. Uso quotidiano

6.1 Spostare un cliente su un altro listino

Si aggiunge una nuova assegnazione con il nodo nuovo e la data da cui parte, e si chiude la precedente con la sua data di fine. La storia resta leggibile: chi aveva quale listino, e quando.

6.2 Leggere la gerarchia dietro un prezzo

Aprire Gerarchia listini prezzi (HPL) e scegliere la gerarchia. Sul nodo del cliente, Mostra antenati lascia solo il percorso fino alla radice, che è l'ordine in cui viene cercato il prezzo; Mostra tutto rimette l'albero intero. Listino prezzi apre i prezzi del nodo.

6.3 Modificare una gerarchia certificata

Si sceglie Riapri, si modifica, si certifica di nuovo. Mentre la gerarchia è aperta non risolve i prezzi, e i documenti di vendita dei clienti assegnati si fermano con un errore: è lavoro da fare in un momento tranquillo e da chiudere.

6.4 Rinominare o eliminare un nodo

Se un nodo di una gerarchia certificata viene rinominato, le assegnazioni che ci puntavano continuano a funzionare senza che si debba fare niente: per il motore resta lo stesso nodo. Se invece il nodo viene eliminato, le assegnazioni non si perdono: restano parcheggiate, senza nodo, e il nome del nodo che avevano si legge nella colonna Listino prezzi precedente. Tornano a posto da sole appena nella stessa gerarchia ricompare un nodo con quel nome, e nel frattempo si possono ripuntare a mano a un altro nodo: in entrambi i casi il parcheggio si svuota. Un nodo con quel nome in un'altra gerarchia non le prende, perché è un nodo diverso con prezzi diversi.

Le assegnazioni parcheggiate da versioni precedenti alla 28.0 non hanno memoria del nome e restano parcheggiate: quelle vanno ripuntate a mano.

7. Dove si trova

• Tell Me: si cerca il nome della pagina, oppure HPL, che è su tutte le pagine dell'app.
• Hub AppLibra: Shift+F12, Esplora altri ruoli, AppLibra, gruppo Listini prezzi gerarchici (HPL).
• Role center Responsabile vendite: lo stesso gruppo nelle sezioni.
• Scheda cliente: gruppo Listini prezzi gerarchici (HPL) e l'azione in Prezzi e sconti.
• Setup manuale: si cerca Setup listino prezzi fra i setup di Business Central.

Le pagine dell'app:

8. Consigli e risoluzione problemi

• Un documento di vendita si ferma con un errore sulla gerarchia: la gerarchia di quel cliente non è certificata. Si certifica, oppure si sposta il cliente su una certificata.
• Il prezzo non cambia: controllare che l'assegnazione in vigore alla data del documento sia quella che si crede, e che il prezzo sia nel listino del nodo o di uno dei suoi antenati. Sulla gerarchia, Mostra antenati fa vedere il cammino esatto che viene percorso.
• Il gruppo prezzi cliente di un cliente non si cambia: quel cliente ha un'assegnazione di listino, e il gruppo arriva dalla gerarchia. Si toglie l'assegnazione, oppure si cambia nodo.
• Un utente con il ruolo operativo apre comunque le pagine di setup: le azioni si vedono da tutti, perché i role center di Business Central funzionano così, e Setup listino prezzi (HPL) e Setup gerarchia listini prezzi (HPL) stanno tutte e due in ALPHPL-ADMIN, ma quell'appartenenza dice chi dovrebbe usarle e non impedisce di aprirle: per aprire una pagina Business Central non chiede il permesso sulla pagina, chiede i permessi sui dati che la pagina legge. Quindi Setup listino prezzi (HPL) si apre anche col solo ruolo operativo, e l'errore di permessi arriva quando si cambia un valore e non quando si apre, perché il setup dell'app è leggibile da tutti e scrivibile solo da ALPHPL-ADMIN; Setup gerarchia listini prezzi (HPL) si apre e si può anche usare, perché i permessi che contano sono quelli sulle tabelle delle gerarchie, che stanno in AL Foundation App e che il ruolo operativo deve avere per poter leggere le gerarchie. Se nella vostra organizzazione costruire le gerarchie deve restare agli amministratori, per adesso è una regola vostra e non un controllo dell'app. Per vedere un nodo senza l'ADMIN si apre la gerarchia dalla scheda cliente: il drill-down la mostra su Gerarchia listini prezzi (HPL), che sta in ALPHPL-USER.
• Mancano i listini dei gruppi: accendere l'interruttore nel setup, così ogni nuovo gruppo prezzi cliente riceve il suo listino, oppure crearli a mano dai listini standard.

9. Supporto e risorse

• Pagina prodotto: https://applibra.com/apps/al-hierarchical-price-list
• Guida: https://applibra.com/apps/al-hierarchical-price-list/help
• Assistenza: i contatti sulla pagina prodotto.
• Condizioni: https://applibra.com/eula - Privacy: https://applibra.com/privacy-policy