Banana Accounting for Microsoft Teams

Banana Contabilità arriva dentro Microsoft Teams. Con la nuova Banana Teams App lavori sulla tua contabilità direttamente dalla finestra di Teams, apri i file salvati su OneDrive o SharePoint senza scaricarli, e li condividi con il tuo team senza cambiare strumento.

Con Banana Teams App è come lavorare in cloud, perché su qualsiasi dispositivo su cui hai installato Teams puoi aprire e salvare file con Banana, senza fare alcun login supplementare. Rispetto agli altri software contabili che lavorano in cloud sei però solo tu che hai il controllo dei tuoi dati, puoi copiare e spostare il file. 

L'app si presenta come una scheda (tab) personale di Teams. Una volta installata, la trovi nella barra laterale di Teams o all'interno di un canale del tuo team, esattamente come qualsiasi altra app Microsoft o di terze parti.

Funzionalità

In sintesi, ti permette di:

• Tenere la contabilità all'interno dell'ambiente di lavoro Teams, vicino a chat, riunioni e documenti
• Aprire e modificare file .ac2 archiviati sul tuo dispositivo, su OneDrive o su SharePoint
• Salvare le modifiche direttamente nel cloud, mantenendo il file sempre disponibile per i colleghi
• Vedere se altri utenti hanno aperto lo stesso file in quel momento
• Aprire un file da un link condiviso (1drv.ms, onedrive.com, sharepoint.com) o un URL pubblico
• Ritrovare velocemente i file recenti e i preferiti, sincronizzati tra dispositivi diversi

L'app è adatta sia per uso individuale che per lavoro di squadra in studi commercialisti, associazioni, ONG e piccole-medie imprese.

Limitazioni

Teams è una tecnologia legata al browser e quindi presenta ancora alcune limitazioni. 
Banana Teams App è ancora in fase di sviluppo e può quindi non offrire tutte le possibilità di Banana Desktop.

• Teams non permette di avere degli zoom differenti per ogni tab o finestra separata.
• Per i file in cloud, non puoi accedere agli allegati. 
• Quando si passa dalla tab di Banana a un'altra e viceversa, il caricamento può richiedere del tempo. 
  Oppure Teams potrebbe chiudere la tab. Meglio aprire Banana in una nuova finestra.

Installare Banana Teams App 

Prerequisiti 

Per usare la Banana Teams App ti servono:

• Un account Microsoft 365 aziendale o scolastico (un account Microsoft personale, tipo Outlook.com non è sufficiente, perché l'app utilizza l'autenticazione single sign-on di Microsoft Teams)
• L'applicazione Microsoft Teams (versione desktop, web o mobile)
• Spazio su OneDrive o SharePoint per archiviare i file di contabilità (consigliato, ma non obbligatorio: puoi anche aprire e salvare file dal tuo dispositivo)
• La possibilità di installare app dal Microsoft Teams Store. In alcune organizzazioni l'amministratore IT deve prima consentire l'app o approvarne i permessi.
• Un browser moderno, se usi Teams nel browser: Edge o Chrome aggiornati. WebAssembly è supportato anche da Firefox e Safari recenti.
• L'app NON È disponibile per gli account personali, perché non hanno la funzionalità di Single sign-on.

Non serve installare alcun software aggiuntivo sul tuo computer: tutto il software Banana Contabilità viene caricato dentro Teams.

Attivare l'app per il tuo tenant

Banana Contabilità è disponibile dal Microsoft Teams Store. Se il tuo tenant Microsoft 365 consente l'installazione delle app pubblicate nello Store, puoi cercarla direttamente in Teams e aggiungerla come qualsiasi altra app.

La disponibilità effettiva dipende però dalle impostazioni della tua organizzazione. L'amministratore Microsoft 365 può:

• Consentire l'installazione delle app pubblicate nel Teams Store
• Bloccare o approvare singole app
• Rendere l'app disponibile solo ad alcuni utenti o gruppi
• Installare o appuntare l'app automaticamente per gli utenti
• Richiedere il consenso amministrativo ai permessi Microsoft 365 dell'app

Installare la Banana Contabilità Teams App

Per aggiungerla al tuo Teams:

1. Apri Microsoft Teams
2. Clicca sull'icona App nella barra laterale sinistra
3. Cerca Banana Contabilità
4. Clicca su Aggiungi 
5. Conferma l'installazione
6. Suggerimento: puoi appuntare l'app nella barra laterale cliccandoci sopra con il tasto destro e scegliendo Appunta (in alcune versioni: Pin), così ti basta un click per aprirla.

Se non trovi l'app, contatta l'amministratore IT della tua organizzazione e chiedi di consentire Banana Contabilità in Microsoft Teams.

Al primo avvio potrebbe essere richiesto il consenso ai permessi Microsoft 365. 

• In alcuni tenant può concederlo direttamente l'utente.
• In altri casi serve l'approvazione di un amministratore. 
• I permessi servono per identificarti e per aprire e salvare, per tuo conto, i file .ac2 a cui hai accesso su OneDrive e SharePoint.

Note tecniche sull'installazione

Banana per Teams è un'applicazione che viene caricata sul Marketplace e viene aggiornata automaticamente ogni volta che noi rilasciamo una nuova versione. 

• Quando installi la Teams App, questa lavora all'interno del tuo spazio di lavoro e di calcolo messo a disposizione da Microsoft.
• Per l'apertura e il salvataggio dei file vengono usate le Azure Functions serverless di Microsoft Graph (OneDrive/SharePoint). Questi servizi sono gestiti da Microsoft e, secondo le specifiche di Microsoft, elaborano la richiesta in modo serverless, senza conservare copie dei dati. 
• Banana.ch, in quanto sviluppatore del software, non ha alcun accesso ai tuoi spazi. Non riceve copie dei tuoi dati, non può vedere cosa fai e tantomeno può accedere o modificare i tuoi file. 

Avvio di Banana Contabilità per Teams

Primo avvio e accesso

La prima volta che apri la Banana Teams App, vedrai una schermata di caricamento con il messaggio "Caricamento di Banana Contabilità...". L'app sta scaricando il motore di Banana e preparando l'ambiente di lavoro: questa operazione può richiedere da pochi secondi a più tempo, soprattutto al primo avvio o con una connessione lenta.

Una volta caricata, l'interfaccia di Banana Contabilità è identica a quella che già conosci dalla versione desktop.

Apri in finestra nuova

Quando lanci Banana direttamente nella finestra di Teams, come una nuova scheda, questa finestra viene automaticamente chiusa quando ti sposti su un'altra scheda di Teams. 

È quindi meglio usare i “...” e scegliere Apri in nuova finestra.

Accessi ai file (single sign-on)

Quando hai effettuato il login in Teams (single sign-on), in Banana hai automaticamente accesso a tutti i tuoi file e alle condivisioni.
Se è la prima volta in assoluto, Teams o Microsoft 365 potrebbero chiedere a te o al tuo amministratore di concedere all'app i permessi di accesso a:

• Il tuo profilo utente
• I file su OneDrive
• I siti SharePoint a cui hai accesso
• Le informazioni di base necessarie per mostrare la presenza dei collaboratori

Questi permessi servono per consentire l'apertura e il salvataggio dei file e per mostrare chi ha aperto lo stesso documento. Senza i permessi richiesti, le funzioni cloud dell'app non possono funzionare.

Aprire e condividere un file di contabilità

Per aprire un file, clicca su Apri dal menu di Banana, oppure utilizza la pagina iniziale dei file recenti. Si aprirà la finestra Carica file dal dispositivo o dal cloud, divisa in quattro schede:

Dispositivo locale 

• La scheda Dispositivo ti permette di selezionare un file .ac2 salvato localmente sul tuo computer. 
• Clicca su Apri dal dispositivo, scegli il file dal selettore di sistema e Banana lo caricherà immediatamente.
• I file aperti dal dispositivo non vengono inseriti nella lista dei file recenti, perché non hanno un'identità stabile nel cloud.

OneDrive

• Nella scheda OneDrive trovi un esploratore dei tuoi file personali su OneDrive for Business. 
• Naviga tra cartelle e sottocartelle come faresti su OneDrive nel browser. Le colonne disponibili mostrano nome, dimensione, data di modifica e autore della modifica.
• Clicca su un file .ac2 per aprirlo: l'app scarica il contenuto in modo sicuro, senza farti uscire da Teams.

SharePoint

• La scheda SharePoint elenca i siti SharePoint a cui hai accesso. 
• Seleziona il sito desiderato, poi naviga tra le librerie di documenti per trovare il file. 
• La struttura è identica a quella di OneDrive: cartelle, file, breadcrumb di navigazione.
• Se appartieni a molti siti, puoi tornare alla radice cliccando sul pulsante home nel breadcrumb.

Apri da URL (file condivisi)

• La scheda Incolla URL ti consente di aprire un file partendo da un link. È utile in tre casi:
  1. Un collega ti ha condiviso un link a un file su OneDrive o SharePoint (1drv.ms, onedrive.com, sharepoint.com): incollalo qui e l'app lo aprirà usando il sistema di sharing di Microsoft Graph
  2. Hai un link diretto a un file .ac2 pubblico su un server web (HTTPS o HTTP)
  3. Stai aprendo un link generato da un'altra applicazione Banana

Link condivisi Microsoft

Quando un collega ti condivide un file .ac2 da OneDrive o SharePoint usando la funzione Condividi di Microsoft 365, ottieni un URL del tipo https://...sharepoint.com/....+Puoi:

• Incollarlo nella scheda Incolla URL dell'app
• Aprire il file da OneDrive o SharePoint con l'opzione Apri con Banana Contabilità, quando disponibile nel menu del file

L'app riconosce automaticamente i domini di Microsoft (onedrive.com, 1drv.ms, sharepoint.com) e usa il sistema di sharing di Graph per scaricare il file con i tuoi permessi.

Incolla il link nel campo URL del file e clicca su Apri URL. Vengono accettati solo link http://+e https://.

Suggerimento:+la combinazione Ctrl+V (o Cmd+V su Mac) è supportata anche dentro la finestra di Teams, anche se Teams in genere blocca l'accesso agli appunti per ragioni di sicurezza.

Pulsante di ricarica

Quando navighi in OneDrive o SharePoint, in alto a destra della finestra trovi un pulsante con l'icona di ricarica. Cliccalo per aggiornare la lista dei file e delle cartelle, ad esempio se un collega ha appena caricato un nuovo documento.

Apri con Banana Contabilità

Quando l'integrazione file di Microsoft 365 è disponibile nel tuo tenant, i file .ac2 salvati su OneDrive o SharePoint possono mostrare l'azione Apri con Banana Contabilità. Se la scegli, Teams apre direttamente Banana Contabilità e carica il file selezionato.

Questa funzione dipende dalla pubblicazione dell'app nel Teams Store, dalla disponibilità dell'integrazione nel tenant e dalle policy configurate dall'amministratore.

Aprire file da link condivisi

La Banana Teams App supporta i deep link, ovvero i link che aprono direttamente un file specifico al posto di mostrarti la pagina iniziale dell'app.

Esistono due modi per usarli:

1. Deep link Teams
   Se inserisci un link di Teams che punta direttamente a un file (con i parametri fileId e source), l'app lo apre automaticamente al primo avvio. Questo è utile, ad esempio, per inserire un link a un file di contabilità in un messaggio di Teams o in una scheda di un canale: chi ci clicca arriva direttamente sul file aperto.
    
2. File recenti e preferiti
   La schermata iniziale di Banana mostra i tuoi file aperti di recente (fino a 8) e quelli che hai marcato come preferiti.

Sincronizzazione fra dispositivi

I file recenti e i preferiti sono memorizzati sia localmente che nel tuo profilo cloud, in modo che li ritrovi anche se apri Teams da un altro computer. La sincronizzazione è automatica.

La lista contiene i riferimenti ai file, come nome, posizione e identificativo cloud. Non contiene il contenuto dei file .ac2.

Operazioni disponibili

• Apri: clicca sul file per riaprirlo. L'app scarica la versione più recente dal cloud, non una copia obsoleta.
• Apri posizione file: ti porta direttamente nella cartella che contiene il file, dentro la finestra di esplorazione di OneDrive o SharePoint.
• Aggiungi ai preferiti: contrassegna un file come preferito. I preferiti non vengono mai rimossi automaticamente dalla lista, anche quando ne apri di nuovi.
• Rimuovi dai recenti: elimina una singola voce dalla lista (il file rimane sul cloud).
• Cancella tutti: svuota completamente la lista dei recenti.

I file aperti dal solo dispositivo non vengono memorizzati nei recenti, perché non hanno un riferimento univoco nel cloud.

Salvare il file

Banana distingue automaticamente fra due situazioni:

• Salva (Ctrl+S): se il file proviene dal cloud, viene aggiornato direttamente nella sua posizione originale (OneDrive o SharePoint), senza chiederti nulla
• Salva con nome: apre la finestra di salvataggio dove puoi scegliere posizione, nome e destinazione

Quando il file salvato proviene dal dispositivo, anche un semplice Salva apre la finestra di salvataggio: è necessario perché il browser, per ragioni di sicurezza, non può sovrascrivere file locali automaticamente.

La finestra di salvataggio

La finestra di salvataggio offre tre destinazioni, simili a quelle di apertura:

• Dispositivo: scarica il file sul tuo computer (cartella Download del browser)
• OneDrive: salva il file sul tuo OneDrive personale, scegliendo la cartella di destinazione
• SharePoint: seleziona prima il sito, poi la cartella

Il campo Nome file ti permette di rinominare il file prima del salvataggio.

Caricamento intelligente

Per i file di grandi dimensioni l'app suddivide automaticamente il caricamento in più parti, in modo da rendere il salvataggio resistente a interruzioni di rete. Per i file più piccoli (sotto i 4 MB) il caricamento avviene in un unico passaggio. Tu non devi fare nulla: è l'app a scegliere il metodo migliore.

Durante il salvataggio vedrai una serie di messaggi di stato:

• "Esportazione .ac2 da Banana..."
• "Verifica della versione remota..."
• "Preparazione del payload di caricamento..."
• "Caricamento in OneDrive..." (o SharePoint)
• "File salvato in OneDrive."

Gestione delle versioni e dei conflitti

Quando lavori su un file condiviso, può capitare che un collega lo modifichi e lo salvi mentre tu lo hai ancora aperto. La Banana Teams App rileva automaticamente questa situazione confrontando la versione del file remoto con quella che hai in memoria.

Se al momento del salvataggio la versione remota è cambiata, l'app non sovrascrive automaticamente il lavoro del collega: invece, ti mostra una finestra di dialogo Il file remoto è cambiato con tre opzioni:

• Sovrascrivi: forza il salvataggio della tua versione, perdendo le modifiche fatte dal collega. Da usare solo se sei sicuro di cosa stai facendo.
• Salva con nome: salva il tuo lavoro come copia separata. L'app suggerisce automaticamente un nome del tipo NomeFile (conflict 2026-05-09 10-30-15).ac2, così poi puoi confrontare le due versioni con calma.
• Annulla: chiude la finestra senza salvare, ti permette di riconsiderare cosa fare.

L'app verifica anche lo scenario opposto: se il file remoto è stato eliminato mentre lavoravi, ti viene proposto direttamente di salvare la tua copia di conflitto.

Presenza dei collaboratori

Quando apri un file .ac2 da OneDrive o SharePoint, la Banana Teams App ti dice se altri colleghi della tua organizzazione hanno lo stesso file aperto in quel momento. Ne vedrai gli avatar (foto del profilo Microsoft 365) accanto al nome del file.

Questo ti aiuta a:

• Coordinarti con il collega prima di iniziare modifiche importanti
• Evitare conflitti di versione, ad esempio mettendoti d'accordo su chi salva per primo
• Avere un riscontro immediato su chi sta consultando o modificando lo stesso file

La presenza viene aggiornata circa ogni 30 secondi e si chiude automaticamente quando chiudi il file o l'app.

Nota tecnica: la presenza non condivide il contenuto del file né modifiche in tempo reale. Mostra solo chi sta lavorando sullo stesso file. Le modifiche vere e proprie restano legate al ciclo "apri - modifica - salva", come nella versione desktop.

Lingue e tema

Lingue supportate

L'interfaccia della Banana Teams App è disponibile in:

• Italiano
• Inglese
• Tedesco
• Francese

La lingua viene scelta automaticamente in base alla lingua del tuo Teams. Se Teams è in italiano, anche l'app sarà in italiano. Se la tua lingua non è fra quelle supportate, l'app usa l'inglese come ripiego.

Tema chiaro e scuro

L'app segue il tema di Teams: chiaro, scuro o ad alto contrasto. Quando cambi tema in Teams, l'app si adatta automaticamente alla nuova combinazione di colori.

Privacy e sicurezza

La sicurezza dei tuoi dati di contabilità è una priorità. Ecco come è progettata l'architettura dell'app:

• Single sign-on: non devi inserire nuovamente la password. L'app usa il token di autenticazione di Teams attraverso il flusso On-Behalf-Of, lo standard Microsoft per le app di Teams.
• Token mai esposti al browser: i token di accesso a OneDrive e SharePoint non vengono mai memorizzati nel browser né nel local storage. Sono trattati esclusivamente lato server.
• Microsoft Graph dietro le quinte: la comunicazione con OneDrive e SharePoint passa sempre attraverso un servizio backend dedicato, che fa da intermediario sicuro fra l'app e Microsoft Graph. Il tuo browser non chiama mai direttamente le API di Microsoft Graph.
• Trasmissione fedele dei file: i file .ac2 vengono trasmessi byte per byte, senza trasformazioni che possano alterare il contenuto. L'app può mantenere copie tecniche temporanee o di recupero solo sul dispositivo dell'utente, dentro IndexedDB, il database locale del browser, per proteggere il lavoro non salvato. Queste copie non vengono usate per condividere i tuoi dati con altri servizi.
• Permessi limitati allo scopo dell'app: l'app richiede i permessi necessari per identificarti, leggere e scrivere i file a cui hai accesso e mostrare la presenza dei collaboratori. Non richiede accesso a email, calendario o chat.

Trovi maggiori dettagli nelle pagine Informativa sulla privacy e Condizioni d'uso, accessibili dal menu dell'app dentro Teams.

Domande frequenti

Posso lavorare offline?

L'apertura del file richiede una connessione attiva, perché Banana viene caricato dinamicamente. Una volta aperto il file, le modifiche locali al documento non richiedono la rete, ma il salvataggio nel cloud sì. Se la connessione cade durante una modifica, puoi sempre salvare il file sul dispositivo come copia di sicurezza.

Banana Teams App sostituisce l'app desktop di Banana Plus?

No: è una modalità aggiuntiva, pensata per chi lavora prevalentemente in Teams. Continui ad avere a disposizione anche la versione desktop completa di Banana Contabilità Plus per Windows, Mac e Linux.

Posso aprire i file .ac2 con la Banana Teams App e poi continuare a lavorarci nella versione desktop?

Sì. Il formato .ac2 è lo stesso. Puoi aprire un file su Teams, salvarlo su OneDrive, poi aprire lo stesso file dalla versione desktop di Banana sincronizzata via OneDrive (o scaricato manualmente).

Cosa succede se chiudo Teams mentre sto lavorando?

L'app rileva la chiusura del tab e ti avvisa se ci sono modifiche non salvate, esattamente come la versione desktop. Esistono inoltre meccanismi di recupero automatico delle modifiche per i casi più estremi.

Posso installare l'app su Teams mobile?

Sì, se l'app è consentita dalla tua organizzazione anche su Teams mobile. L'esperienza è pensata soprattutto per desktop, browser e tablet; su smartphone alcune operazioni possono risultare meno comode a causa delle dimensioni dello schermo.

Quante persone possono modificare lo stesso file contemporaneamente?

Tecnicamente, più persone possono aprire lo stesso file allo stesso tempo, e l'app vi avvisa visivamente con gli avatar di presenza. Non si tratta però di co-authoring in tempo reale come in Word o Excel: ogni utente lavora sulla propria copia aperta e salva poi il risultato nel cloud. Se nel frattempo la versione remota è cambiata, l'app mostra il dialog di conflitto e ti permette di sovrascrivere, salvare una copia separata o annullare. Il consiglio è di coordinarsi nel team prima di iniziare a modificare un file già in uso.

Come posso segnalare un problema o suggerire un miglioramento?

Contatta il supporto Banana.ch attraverso il formulario di contatto. Nella segnalazione, ricordati di indicare che stai usando la versione Teams App, così il team di supporto può indirizzarti subito alla persona giusta.

In conclusione

La Banana Teams App porta la potenza di Banana Contabilità Plus dentro l'ambiente di lavoro che già usi ogni giorno. Apri i tuoi file ovunque siano, salva direttamente nel cloud e lavora sui documenti condivisi senza scambi di email: tutto in un unico posto.

Se non l'hai ancora installata, prova ad aggiungerla a Teams oggi stesso. Per qualsiasi domanda o supporto, il sito banana.ch è sempre a tua disposizione.