AL Spirits Recipe - Guida utente

1. Concetti in un minuto

• Una ricetta elenca gli ingredienti che servono per 100 unità di ciò che produce. È aperta mentre la si scrive e rilasciata quando si può usare.
• Articoli da produrre. Una ricetta può produrre più di un articolo. Per ognuno si inserisce la quantità da produrre, oppure il suo peso netto totale, e l'app mostra i litri idrati e i litri anidri di quella quantità.
• Righe di alcol. Un ingrediente conta come alcol quando la sua % alcol supera il minimo del setup. Le righe di alcol non si consumano in proporzione alla quantità: vengono dimensionate per fornire i litri anidri di ciò che si produce, al netto di quelli portati dagli altri ingredienti.
• La riga dell'acqua bilancia la ricetta e non si consuma: resta fuori dalle registrazioni ricetta e dalla distinta base di produzione.
• Collocazione e lotto. Ogni riga può dire da dove si preleva l'ingrediente. L'app propone la collocazione predefinita e il lotto con la quantità maggiore, e legge la % alcol di quel lotto. Collocazione, lotto e % alcol della riga restano coerenti fra loro.
• La % alcol è quella del lotto. Quando un ingrediente viene scaricato da una collocazione, la riga di registrazione prende la % alcol del lotto che si trova lì, e i litri la seguono. La % alcol dell'articolo è il valore di partenza, per quando il lotto non ne ha una.
• Si produce con l'ordine di produzione. L'ordine di produzione passa dalla produzione standard di Business Central, con una numerazione sua, così la ricetta viene valorizzata come ogni altra produzione. Le registrazioni ricetta restano solo per i confronti, dove il setup le abilita.
• Un travaso sposta un prodotto da un lotto a uno nuovo, con due righe di registrazione.

2. Prerequisiti

• Microsoft Dynamics 365 Business Central, versione 28.0 o superiore, online (SaaS) e on-premises. L'app non è pubblicata su AppSource: distribuzione e installazione sono dirette di AppLibra.
• Localizzazione: Italia, perché l'app dipende da AL Excise.
• Le dipendenze installate: AL Foundation App, AL License and Trial Management, AL Role Center, AL Message Passing, AL Excise, AL Catch Weight Management, AL Tracking, AL Packaging, AL Document Template e AL Zebra ZPL Label Manager.
• Permessi: due ruoli. ALPSPR-USER per chi lavora con le ricette ogni giorno: scrive le ricette, indica che cosa produrre e crea registrazioni ricetta, travasi e ordini di produzione. ALPSPR-ADMIN per chi configura l'app: include il primo e aggiunge il setup, gli ingredienti e la cancellazione delle ricette. Chi aveva il vecchio set AL RECIPE si ritrova ALPSPR-ADMIN assegnato dopo l'aggiornamento. Se il vecchio set veniva dato in automatico ai nuovi utenti per tipo di licenza, quella configurazione va rifatta a mano.
• Fino all'8 ottobre 2026 l'app si chiamava AL Recipe. Dati e impostazioni sono gli stessi.

3. Setup

3.1 Attivare la licenza

Aprire Setup ricette (SPR). Il primo salvataggio del setup avvia il periodo di prova; l'azione Aggiungi licenza installa la licenza ricevuta da AppLibra.

3.2 Setup ricette (SPR)

• Nome definizione registrazioni ricetta e Nome batch registrazioni ricetta: le registrazioni magazzino in cui vengono create le righe delle registrazioni ricetta e dei travasi.
• Filtro tipo articolo ricette: quali tipi di articolo si gestiscono a ricetta. La pagina delle righe di vendita delle ricette mostra solo le righe di questi articoli, e non si apre finché il filtro è vuoto.
• Abilita Crea registrazioni ricetta: mostra l'azione Crea registrazioni ricetta sulla scheda ricetta e sulle righe di vendita delle ricette. L'azione produce una ricetta dalle registrazioni magazzino, senza ordine di produzione. Si lascia disattivato dove le ricette si producono con gli ordini di produzione.
• Nr. ricette: la numerazione da cui una ricetta nuova prende il numero.
• Nr. ordini di produzione ricette: la numerazione degli ordini di produzione creati dalle ricette.
• Nr. serie registrazioni ricetta: la numerazione che assegna il numero di documento alle righe di registrazione.
• % alcol minima: la % alcol oltre la quale un ingrediente conta come alcol.

3.3 Ingredienti (SPR)

Un'anagrafica di materie prime, allergeni, rischi e denominazioni, ognuno con il suo tipo. Una ricetta può fare riferimento a uno per tipo. Questi riferimenti descrivono la ricetta: non entrano nei calcoli.

3.4 Registrazioni di ogni utente

Nel Setup utente, per ogni persona che produce dalle ricette con gli ordini di produzione: le registrazioni consumi e le registrazioni output, ognuna con la sua definizione e il suo batch. La scheda ricetta compila e apre queste registrazioni per quell'utente. Le registrazioni ricetta e i travasi non passano da qui: usano le registrazioni del Setup ricette.

3.5 Gli articoli

% alcol, capacità e K vengono dall'articolo, dove li tiene AL Excise: vanno impostati lì per gli articoli da produrre e per gli ingredienti alcolici. Per un ingrediente tenuto a lotti la % alcol dell'articolo è il valore di partenza: quando la riga ha un lotto con la sua % alcol, vale quella.

4. Uso quotidiano

4.1 Scrivere una ricetta

Aprire Ricette (SPR) e creare una ricetta. Lasciando vuoto il numero, la ricetta prende il successivo dalla numerazione del setup; con il pulsante di assistenza si sceglie un'altra numerazione fra quelle collegate. Un numero scritto a mano può avere al massimo 10 caratteri ed è accettato solo se la numerazione ammette i numeri manuali. Inserire poi una descrizione.

Sulle righe inserire gli ingredienti: l'articolo, l'unità di misura e la quantità che serve per 100 unità di ciò che la ricetta produce. Segnare la riga dell'Acqua. La spunta Alcol la mette l'app in base alla % alcol dell'articolo. Sulle righe di alcol la quantità stabilisce solo le proporzioni fra di esse, e l'unità di misura può essere qualunque unità che l'articolo converte in litri.

Quando la ricetta è pronta, portare lo Stato a Rilasciata. In questo passaggio l'app non controlla la ricetta: verificare che le righe siano complete.

4.2 Scegliere da dove vengono gli ingredienti

Su ogni riga inserire il Cod. ubicazione. L'app propone la collocazione predefinita dell'articolo e il lotto con la quantità maggiore che vi si trova, e sostituisce la % alcol della riga con quella del lotto. Suggerisci collocazione e lotto lo fa per tutte le righe che hanno un'ubicazione.

Collocazione e lotto si possono cambiare a mano, e la riga resta coerente:

• Cambiando la collocazione, l'app propone il lotto con la quantità maggiore di quella collocazione e ne prende la % alcol.
• Scegliendo un lotto che si trova in un'altra collocazione, la riga si sposta lì e prende la % alcol di quel lotto. Se il lotto si trova in più collocazioni, l'app chiede di scegliere prima la collocazione.
• Un lotto che non ha giacenza nell'ubicazione lascia la collocazione e la % alcol come sono. Lo stesso vale per un lotto che non ha una % alcol.
• Collocazione e lotto si inseriscono dopo l'ubicazione.

La % alcol di un lotto è quella dei carichi del lotto ancora presenti nella collocazione: la tiene AL Excise sui movimenti.

4.3 Indicare che cosa produrre

In Articoli da produrre inserire l'articolo che la ricetta produce e la Qtà da produrre. Se si conosce il peso, inserire il Peso netto totale da produrre e la quantità viene calcolata tramite K. La riga mostra i litri idrati e i litri anidri di quella quantità.

4.4 Produrre con un ordine di produzione

La prima volta che un articolo si produce con una ricetta, la sua distinta base di produzione va certificata a mano. Crea o aggiorna DB dell'articolo da produrre la scrive dalla ricetta e la apre: controllarla e portarne lo Stato a Certificato. Finché non è certificata, Apri nuovo ordine di produzione si ferma e lo dice. Dagli ordini successivi l'app la aggiorna dalla ricetta e la riporta a certificata da sé.

Apri nuovo ordine di produzione aggiorna la distinta base di produzione dell'articolo dalla ricetta, crea un ordine di produzione rilasciato per la quantità da produrre e lo apre. Se esiste già un ordine rilasciato dello stesso articolo da produrre senza niente di finito, apre quello. Dalla scheda ricetta, Calcola consumi compila le registrazioni consumi dell'utente a partire dall'ordine ed Esplodi ciclo nelle registrazioni output compila le registrazioni output; poi si registrano come di consueto.

Ogni riga di consumo prende la % alcol del lotto che si trova nella collocazione da cui preleva, e i litri della riga vengono ricalcolati con quella % alcol. Se il lotto non ha una % alcol, la riga tiene quella che aveva.

Crea o aggiorna DB dell'articolo da produrre aggiorna la sola distinta base di produzione, senza creare un ordine.

4.5 Le registrazioni ricetta, per i confronti

Le registrazioni ricetta producono una ricetta direttamente dalle registrazioni magazzino, senza ordine di produzione. Restano per confrontare i risultati con il modo di lavorare precedente, e l'azione compare solo se nel Setup ricette (SPR) è attivo Abilita Crea registrazioni ricetta: dove le ricette si producono con gli ordini di produzione resta nascosta.

Crea registrazioni ricetta scrive, nelle registrazioni del setup, una rettifica positiva per la quantità da produrre e una rettifica negativa per ogni ingrediente, acqua esclusa, e apre quelle registrazioni. Non viene registrato niente: controllare quantità e lotti, e registrare. La quantità da produrre torna a zero.

Ogni riga di scarico porta la collocazione, il lotto e la % alcol della riga ricetta. Cambiando la collocazione nelle registrazioni, l'app rilegge il lotto con la quantità maggiore di quella collocazione, la sua % alcol e i litri.

4.6 Travasare un prodotto in un lotto nuovo

Crea travaso scrive due righe di registrazione per la quantità da produrre: una rettifica negativa sul lotto con la quantità maggiore e una rettifica positiva dello stesso articolo su un numero di lotto nuovo, e apre le registrazioni del setup. Le due righe nascono nell'ubicazione dell'articolo da produrre, la stessa che prenderebbe un suo ordine di produzione. Se il prodotto si sposta, cambiare la collocazione nelle registrazioni, poi registrare.

4.7 Partire dagli ordini di vendita

Righe di vendita ricette (SPR) elenca le righe degli ordini di vendita non ancora spedite degli articoli gestiti a ricetta. Mostra ricetta apre la ricetta dell'articolo. Prepara Ordine la apre con la quantità da produrre impostata sulla quantità inevasa della riga, e mantiene il collegamento: le registrazioni ricetta prendono il numero d'ordine e l'ubicazione della riga. Alla registrazione dell'output la riga di vendita riceve la quantità prodotta, il suo peso netto e la % alcol, e il lotto prodotto.

5. Dove si trova

• Tell Me: cercare "SPR" (ogni pagina dell'app ha la sigla), oppure la pagina per nome, per esempio "Ricette (SPR)".
• Role center: un gruppo Ricette per alcolici (SPR) con ricette e righe di vendita delle ricette sul role center del pianificatore di produzione. Le pagine di setup sono sull'hub AppLibra.
• Hub AppLibra: Shift+F12, Esplora altri ruoli, AppLibra.
• Setup manuale: la pagina di setup è registrata nell'elenco Setup manuale.
• Setup utente: le registrazioni di ogni utente.

6. Consigli e risoluzione problemi

• La pagina delle righe di vendita delle ricette non si apre. Il Filtro tipo articolo ricette del setup è vuoto. Va compilato.
• Crea registrazioni ricetta non si vede. Nel setup non è attivo Abilita Crea registrazioni ricetta.
• Crea registrazioni ricetta non fa niente o si ferma. La ricetta deve essere rilasciata, e nel setup devono esserci la definizione e il batch delle registrazioni.
• Un numero di ricetta viene rifiutato. Il numero ha al massimo 10 caratteri, e scritto a mano è accettato solo se la numerazione delle ricette ammette i numeri manuali.
• Una riga non è segnata come alcol. La % alcol del suo articolo non supera la % alcol minima del setup.
• L'alcol consumato non è quello atteso. Sulle righe di alcol la quantità stabilisce solo le proporzioni: il consumo viene dai litri anidri da produrre, al netto di quelli portati dagli altri ingredienti. Controllare la % alcol dei lotti sulle righe.
• L'app dice che una riga di alcol non ha la % alcol. Una riga di alcol senza % alcol non si può dimensionare, in nessuna unità di misura. Indicare il lotto, con Suggerisci collocazione e lotto o a mano, oppure la % alcol sulla riga.
• L'app dice che non riesce a calcolare la quantità di una riga. Succede su una riga di alcol in un'unità che l'articolo non converte in litri: la quantità si ricava dai litri anidri che una unità contiene. Controllare le unità di misura dell'articolo. Se l'ingrediente va dosato per la quantità scritta in ricetta, come un aroma, togliere la spunta Alcol: il suo alcol viene contato lo stesso.
• La % alcol di una riga di registrazione è diversa da quella dell'articolo. La riga che scarica da una collocazione prende la % alcol del lotto che si trova lì, anche quando la scheda articolo ne ha un'altra. Se non è quella attesa, controllare con quale % alcol il lotto è stato caricato.
• Nelle registrazioni ricetta manca l'acqua. È voluto: la riga dell'acqua non si consuma.
• Apri nuovo ordine di produzione dice che la distinta base non è certificata. È la prima produzione di quell'articolo con quella ricetta, oppure qualcuno ha tolto la certificazione. Usare Crea o aggiorna DB dell'articolo da produrre, controllare la distinta base e certificarla, poi aprire l'ordine.
• Le registrazioni consumi o output non si aprono. Nel Setup utente non sono indicate le registrazioni di quell'utente.
• Un utente riceve un errore di permessi sul setup. I role center mostrano l'azione di setup a tutti; la pagina di setup richiede ALPSPR-ADMIN.
• Cosa l'app non fa. Allergene, rischio e denominazione di una ricetta sono descrittivi: l'app non li stampa e non li controlla. Il rilascio di una ricetta non ne verifica le righe.

7. Supporto e risorse

• Editore: AppLibra - https://applibra.com
• Catalogo app: https://applibra.com/apps
• Informativa sulla privacy: https://applibra.com/privacy-policy
• Contratto di licenza: https://applibra.com/eula