AL Foundation App - Guida utente

Configurazione e uso in Business Central.

1. Che cos'è AL Foundation App

AL Foundation App è la base su cui sono costruite le app AppLibra. Si installa insieme a loro e non ha un lavoro quotidiano suo: tiene quello che le app hanno in comune, così ogni app fa la stessa cosa nello stesso modo. Che cosa tiene:

il dettaglio di vendite e acquisti, scritto alla registrazione dei documenti;
un identificativo stabile di documenti e righe, che le app usano per collegare i propri dati;
il setup degli addebiti articolo che le app aggiungono da sole ai documenti;
l'unità di misura che la società usa per peso, pezzi, litri, area e cubatura;
i tipi articolo, una classificazione degli articoli che le app usano come filtro;
strutture e gerarchie di clienti, articoli, agenti e gruppi liberi.

Le sue pagine portano la sigla (FND): cercando FND in Business Central si trovano tutte. Nel Role Center di AppLibra stanno sotto Foundation (FND).

2. Setup

Aprire Setup (FND). La pagina crea il setup la prima volta che viene aperta. Si trova anche nell'elenco dei setup manuali di Business Central, dove si cerca il setup di qualunque altra app.

Salta registrazione magazzino in C/G: registrando i movimenti articolo, il valore di magazzino non viene registrato in contabilità generale e il setup registrazioni magazzino non viene controllato. Il valore si registra dopo con il processo batch standard Registra costo magazzino in C/G.
Salta righe commento: le righe di commento di un documento, quelle con il tipo vuoto, restano fuori dal dettaglio vendite e acquisti. È attivo per impostazione predefinita.

L'azione Aggiorna ID mappa testata è di manutenzione: riallinea, sulle righe dei documenti di vendita e di acquisto aperti e registrati, l'identificativo della loro testata. Si esegue dopo un aggiornamento, se le righe hanno perso il collegamento alla testata.

3. Unità di misura per tipo

Diverse app devono sapere qual è l'unità di misura della società per il peso, o per i pezzi, senza chiederlo ogni volta. Nella pagina standard Unità di misura lo dicono due campi:

Tipo: che cosa misura l'unità: peso, pezzi, litri, area o cubatura. Altre app possono aggiungere i propri tipi.
Priorità: quale unità vince quando più unità hanno lo stesso tipo. Vince la priorità più alta e, a parità di priorità, la prima unità per codice.

Quando si dà a una seconda unità un tipo che un'altra unità ha già, un messaggio dice qual è. Se nessuna unità ha il tipo peso, pezzi o litri, la prima volta che un'app ne ha bisogno viene creata l'unità KG, PZ o LT, oppure viene classificata se esiste già.

4. Tipi articolo

Aprire Tipi articolo (FND). Un tipo articolo ha un codice, una descrizione e:

Tipo: la natura degli articoli, ad esempio materiale, semilavorato o prodotto finito. Altre app aggiungono i propri valori, ad esempio pallet, imballo o contrassegno.
Salta controllo prezzo: le righe di vendita con articoli di questo tipo possono non avere un prezzo unitario. Le app che pretendono un prezzo sulle righe di vendita saltano il controllo per questi articoli.

Il tipo articolo si assegna sulla scheda articolo, nel campo Nr. tipo articolo; la natura viene copiata sull'articolo. Il tipo articolo segue l'articolo sulle righe di vendita, di acquisto e di trasferimento e nel dettaglio, dove le app lo usano come filtro e come condizione: provvigioni, omaggi, contributi per gli imballaggi, qualità, ricette, Intrastat.

5. Setup addebiti articolo

Alcune app aggiungono da sole righe di addebito articolo a un documento: accise, contrassegni, omaggi, RAEE, costi di lavorazione. In Setup addebito articolo (FND) si dice quale addebito articolo usa ciascuna. Una riga per tipo di addebito e codice:

Tipo di addebito articolo: il genere di addebito. Ogni app porta i propri tipi.
Nr.: il codice del setup all'interno del suo tipo.
Codice addebito articolo: l'addebito articolo che viene aggiunto al documento. Si possono scegliere solo gli addebiti articolo dello stesso tipo: il tipo di un addebito articolo si indica nella pagina Addebiti articoli.
Mantieni Cat. reg. articolo/servizio e Mantieni Cat. reg. art./serv. IVA: la riga di addebito mantiene le categorie di registrazione della riga a cui si riferisce, invece di quelle dell'addebito articolo.

Cancellando una riga di documento si cancellano anche le righe di addebito che la richiamano.

6. Certificazioni

Certificazioni (FND) è un elenco di codici con una descrizione. Il codice si inserisce nel campo Nr. certificazione di ordini e fatture di vendita e di acquisto. Le righe aggiunte dopo lo prendono dalla testata; quelle già presenti non cambiano. Quando si fatturano spedizioni o ricezioni, le righe della fattura lo prendono dalle righe spedite o ricevute.

7. Dettaglio vendite e acquisti

Quando un documento viene registrato, l'app scrive una riga per ogni riga del documento, con accanto i campi della testata: cliente o fornitore, agente, date, condizioni di pagamento. Le app leggono questo dettaglio per provvigioni, premi, statistiche e business intelligence; lo si può leggere anche direttamente.

Dettaglio vendite (FND): fatture e note di credito di vendita registrate. Gli importi sono in valuta locale, con a fianco gli importi nella valuta del documento.
Dettaglio acquisti (FND): fatture e note di credito di acquisto registrate, con anno, mese, settimana e giorno della settimana della data documento.
Dettaglio spedizioni vendita (FND): spedizioni e carichi da reso registrati, e anche fatture e note di credito. Li distingue il tipo documento.
Dettaglio ricezioni acquisto (FND): ricezioni e spedizioni di reso registrate, e anche fatture e note di credito.

L'annullo di una spedizione o di un carico da reso scrive nel dettaglio la riga di storno. Da ogni elenco, Mostra documento apre il documento registrato da cui proviene la riga.

ID mappa record (FND) elenca gli identificativi dati a documenti e righe. Serve per i controlli: le app usano l'identificativo per collegare i propri dati a un documento, così il collegamento regge qualunque numero il documento prenda.

Ricalcola dettaglio vendite e acquisti (FND) ricostruisce il dettaglio di un periodo partendo dai documenti registrati. Si indicano le date di registrazione e si sceglie quale dettaglio ricostruire. Una riga che esiste viene sostituita e conserva il suo identificativo; una che manca viene creata. Si usa dopo una migrazione di dati, o quando il dettaglio di un periodo non corrisponde ai documenti registrati.

8. Strutture e gerarchie

Una struttura è un nodo: un gruppo libero, oppure un record come un cliente, un fornitore, un articolo, un agente, un gruppo prezzi cliente, una categoria sconto cliente o una campagna. Le gerarchie mettono le strutture una sotto l'altra, e le app le usano per decidere che cosa vale per chi: gli agenti sotto un capo area, i clienti di un accordo premi, i gruppi prezzi di un listino.

Modelli gerarchie (FND): un modello dice a che cosa servono le sue gerarchie e con quali pagine si vedono e si impostano. Le app creano i propri modelli.
Batch struttura (FND), dall'azione Batch di un modello: un batch è una gerarchia. Il suo stato è Aperto, Certificato o Chiuso. Righe e attributi si modificano solo a batch aperto.
Lista strutture (FND): le strutture, con il record che ciascuna rappresenta. Compilando il numero origine, nome e descrizione arrivano da quel record.

La gerarchia vera e propria si modifica nella pagina dell'app che la usa, ad esempio la gerarchia agenti di AL Commissions. Le regole sono le stesse ovunque: una struttura compare una sola volta in un batch, il padre deve essere nel batch prima dei figli, una riga con figli non si può cancellare, e una riga può avere una data di inizio e una di fine.

9. Campi aggiunti ai documenti

AL Foundation App tiene anche alcuni campi che leggono altre app:

Nr. conto bancario pagamento: il conto bancario della società per il pagamento. Sulla scheda cliente è quello abituale, e i nuovi documenti di vendita lo prendono da lì; dal documento passa al movimento contabile cliente e al dettaglio vendite.
Nr. certificazione: vedere la sezione 6.
Tipo ricevuta, Nr. ricevuta, Data ricevuta, Riferimento fiscale ricevuta su fatture e note di credito di vendita: lo scontrino già emesso per la vendita. I campi sono nascosti: la localizzazione italiana li mostra sulle fatture (sezione 11), altrove si aggiungono con la personalizzazione.
Trasporto a cura di e Ora spedizione su ordini di vendita e di trasferimento: chi cura il trasporto, e l'ora in cui viene spedita la merce.

10. Cosa possono fare i due ruoli

Localizzazione italiana

AL Foundation App ha due set di permessi assegnabili.

AL Foundation App - Utente (ALPFND-USER) è quello che serve a ogni utente di un'app AppLibra. Il dettaglio e gli identificativi li scrive l'app mentre i documenti vengono modificati e registrati, quindi chi registra deve poterli scrivere. Setup, tipi articolo, setup addebiti e certificazioni si leggono ma non si modificano.
AL Foundation App - Amministratore (ALPFND-ADMIN) comprende il ruolo utente e aggiunge le tabelle di setup e il controllo completo sul dettaglio.

Chi riceve il set di permessi di un'app AppLibra ha bisogno anche del ruolo utente. Si assegna insieme al set dell'app, a meno che la guida di quell'app dica che il suo set lo comprende già.

Aggiornamento da una versione precedente

Fino alla versione 25 i permessi dell'app stavano in un unico set, AL Foundation App. L'aggiornamento toglie quel set e lo sostituisce con AL Foundation App - Amministratore, che dà gli stessi permessi. Il passaggio è automatico: chi aveva il vecchio set assegnato riceve quello nuovo, e se il vecchio set era compreso in un set di permessi del cliente, quel set ora comprende quello nuovo.

C'è un caso che l'aggiornamento non può coprire: se il vecchio set era indicato nella pagina Configurazione licenze (License Configuration), fra i permessi che Business Central dà ai nuovi utenti, quella configurazione va rifatta a mano con il set nuovo. Business Central non permette a un'app di modificarla. Gli utenti esistenti non ne risentono.

11. Localizzazione italiana

AL Foundation App IT è la localizzazione italiana dell'app: un'offerta separata per il mercato italiano, che installa insieme a sé AL Foundation App. Non ha pagine proprie. Aggiunge due cose.

Lo scontrino nella fattura elettronica. Sulla fattura di vendita e sulla fattura di vendita registrata diventano visibili i campi Tipo ricevuta, Nr. ricevuta, Data ricevuta e Riferimento fiscale ricevuta. Quando una fattura o una nota di credito di vendita registrata ha un tipo ricevuta, la fattura elettronica prodotta da AL Fatturazione Elettronica porta sulle righe un blocco AltriDatiGestionali con il tipo (Scontrino), il riferimento fiscale, il numero e la data dello scontrino. Un documento senza tipo ricevuta non riceve il blocco.
I campi italiani nel dettaglio spedizioni vendita. Codice progetto fattura (CUP), codice offerta fattura (CIG), numero dell'ordine di acquisto del cliente, codice attività, tipo operazione, data esecuzione operazione, conto bancario, sconto pagamento e data di scadenza vengono copiati dal documento registrato in Dettaglio spedizioni vendita (FND).

Il suo set di permessi, AL Foundation App IT - Utente (ALPFNDIT-USER), comprende il ruolo utente di AL Foundation App. Fino alla versione 25 i permessi stavano nel set AL Foundation App IT: l'aggiornamento sposta assegnazioni e inclusioni sul set nuovo, come descritto nella sezione 10.