⇄
Fatture in Cloud
Documentazione completa
Configurazione, diagnostica, domande frequenti e glossario — tutto in un’unica pagina.
Come attivare la sincronizzazione
Tutta la configurazione avviene dal portale SIBIA. Non è necessario installare nulla sul tuo PC.
Vai su sibia.it e completa la registrazione: scegli le tue credenziali di accesso e accetta la Privacy Policy e le condizioni del servizio. Se hai già un account, accedi direttamente con le tue credenziali.
Nella sezione Dati Registrazione inserisci la ragione sociale e i dati della tua azienda. Questo passaggio sblocca tutte le altre sezioni del portale.
Nel menu laterale del portale clicca su Servizi. Nella griglia che compare, clicca sulla scheda Synchroteam ↔ Fatture in Cloud: si apre la pagina di configurazione del servizio.
Nella scheda Configurazione compila i seguenti campi:
— Dominio Synchroteam: inserisci solo il prefisso del tuo indirizzo (es. miazienda se l’URL è miazienda.synchroteam.com)
— API Key Synchroteam: la trovi espandendo la sezione Come ottenere le credenziali nella stessa pagina, oppure in Synchroteam su Impostazioni → Integrazioni → Chiave API
— Quando importare gli interventi: scegli Al completamento (default) oppure Dopo la validazione
Clicca Salva configurazione per memorizzare le impostazioni.
Clicca il pulsante Collega Fatture in Cloud: verrai reindirizzato alla pagina ufficiale di FIC dove potrai autorizzare l’accesso. La tua password FIC non viene mai condivisa con SIBIA. Dopo l’autorizzazione tornerai automaticamente al portale con la connessione attiva.
Nella sezione Fatturazione attiva la demo gratuita (14 giorni, fino a 50 sincronizzazioni) oppure sottoscrivi direttamente un abbonamento. La sincronizzazione parte automaticamente.
Impostazioni opzionali
Dopo aver salvato la configurazione base, puoi attivare queste funzioni aggiuntive dalla scheda Articolo ore lavoro:
-
Articolo ore lavoro
Piano avanzato
Seleziona un articolo del tuo catalogo FIC da usare per le ore di manodopera nei documenti generati automaticamente dagli interventi. -
Sincronizza catalogo articoli
Piano avanzato
Abilita la sincronizzazione giornaliera del catalogo prodotti da Fatture in Cloud verso Synchroteam. I prodotti FIC vengono copiati come part type in Synchroteam ogni 24 ore, così i tecnici trovano nell’app gli articoli aggiornati con i prezzi corretti.
Risoluzione dei problemi
Trova il sintomo che stai osservando e segui la procedura di risoluzione.
Verifiche da fare dal portale:
- Vai alla sezione Servizi → Synchroteam ↔ Fatture in Cloud e controlla i badge di stato: entrambe le connessioni (Synchroteam e Fatture in Cloud) devono essere verdi.
- Vai alla sezione Fatturazione e verifica che il servizio sia attivo (demo o abbonamento). Se la demo è scaduta o l’abbonamento non è attivo, la sincronizzazione si ferma.
- Controlla che non ci siano messaggi di errore nel pannello di stato del portale.
Causa: SibiaConnector non riesce ad abbinare automaticamente il cliente Synchroteam con il corrispondente cliente su Fatture in Cloud. Questo accade quando il nome è scritto in modo diverso sulle due piattaforme, o quando il cliente esiste solo su Synchroteam e non ancora su FIC.
Soluzione dal portale SIBIA:
- Vai alla sezione Servizi → Synchroteam ↔ Fatture in Cloud
- Apri il pannello Clienti da collegare
- Per ogni cliente in attesa scegli una delle tre azioni:
- Associa: il cliente esiste su FIC con un nome leggermente diverso. Seleziona il candidato suggerito e conferma l’abbinamento.
- Crea su FIC: il cliente non esiste ancora su FIC. SibiaConnector lo crea e lo collega automaticamente.
- Ignora: non vuoi sincronizzare i lavori di quel cliente. Puoi cambiare questa scelta in qualsiasi momento.
Causa: le ore e il prezzo vengono letti dal work report di Synchroteam, non dall’intervento principale. Se il tecnico chiude l’intervento senza compilare il work report, questi campi risultano vuoti.
Come verificare:
- In Synchroteam, apri l’intervento in questione
- Verifica che sia presente un Work Report compilato (non solo l’intervento aperto)
- Controlla che nel work report siano inserite le ore e i materiali con prezzo
Soluzione: chiedi al tecnico di completare il work report sull’app Synchroteam. Una volta compilato, il documento su FIC verrà aggiornato nel ciclo successivo.
Come funziona: la sincronizzazione clienti va da FIC verso Synchroteam. Le modifiche fatte su FIC vengono rilevate tramite la data di aggiornamento e propagate a Synchroteam nel ciclo successivo.
Se l’aggiornamento non avviene:
- Controlla nel portale SIBIA che la sincronizzazione stia girando normalmente (data dell’ultimo ciclo aggiornata)
- Verifica che il cliente sia abbinato correttamente e non in stato in attesa
- Attendi il ciclo successivo
Causa più comune: la chiave API Synchroteam è cambiata o non è più valida.
- In Synchroteam, accedi come amministratore e vai su Impostazioni → Integrazioni → Chiave API
- Verifica che la chiave non sia stata rigenerata: se sì, la vecchia non funziona più
- Copia la chiave API attuale
- Nel portale SIBIA, sezione Servizi → Synchroteam ↔ FIC, aggiorna la chiave API e salva
Come funziona la connessione FIC: SibiaConnector usa OAuth 2.0 — il token di accesso (validità 24 ore) si rinnova automaticamente usando il refresh token (validità ~1 anno). In condizioni normali non scade mai senza preavviso.
Cause possibili dell’errore:
- L’accesso FIC è stato revocato manualmente da Fatture in Cloud → Impostazioni → App collegate
- Il refresh token è scaduto dopo lungo periodo di inattività
Soluzione:
- Nel portale SIBIA, sezione Servizi → Synchroteam ↔ FIC
- Clicca Scollega Fatture in Cloud e poi Collega Fatture in Cloud
- Segui la procedura OAuth sulla pagina ufficiale FIC e torna al portale
Causa: il campo personalizzato Sincronizzato FIC nel modulo Clienti di Synchroteam non esiste, è stato rinominato o eliminato. Senza questo campo il sistema non può tracciare quali clienti sono già stati sincronizzati.
Come creare il campo:
- Accedi a Synchroteam come amministratore
- Vai su Impostazioni → Campi personalizzati → Clienti
- Crea un nuovo campo con il nome esatto: Sincronizzato FIC
- Imposta i valori suggeriti: SI e NO
- Salva: il sistema rileverà automaticamente il campo al ciclo successivo
Causa: Fatture in Cloud consente di gestire più aziende nello stesso account. SibiaConnector deve sapere su quale azienda creare i documenti. Se l’azienda non è stata selezionata durante la configurazione OAuth, appare questo errore.
Soluzione:
- Nel portale SIBIA, sezione Servizi → Synchroteam ↔ FIC
- Scollega e ricollega Fatture in Cloud tramite il pulsante OAuth
- Al termine dell’autorizzazione, il portale ti chiederà di selezionare l’azienda FIC corretta
- Salva la selezione
Cause normali (nessuna azione richiesta):
- Rate limit API: Synchroteam accetta fino a 1.000 richieste/minuto; Fatture in Cloud fino a 300 richieste ogni 5 minuti. Quando ci sono molti dati da sincronizzare, il sistema rallenta automaticamente rispettando questi limiti. I dati arrivano comunque, con qualche minuto in più.
- Primo ciclo clienti: al primo avvio, vengono importati tutti i clienti presenti su FIC (storico completo). Per anagrafiche grandi questo ciclo iniziale può durare diversi minuti; i cicli successivi sono molto più veloci perché sincronizzano solo le modifiche recenti.
- Errori temporanei API: se Synchroteam o FIC sono irraggiungibili, il sistema riprova automaticamente con attese progressive (fino a 20 secondi tra un tentativo e l’altro). Nessun dato viene perso.
Come funziona ArticleSync: la sincronizzazione del catalogo da FIC verso Synchroteam avviene ogni 24 ore. Deve essere abilitata esplicitamente dalla sezione Servizi del portale (opzione Sincronizza catalogo articoli).
Verifica:
- Nel portale SIBIA, sezione Servizi → Synchroteam ↔ FIC, controlla che l’opzione Sincronizza catalogo articoli sia attivata
- Se è appena stata abilitata, attendi il prossimo ciclo (si esegue ogni 24 ore)
- Verifica che su FIC gli articoli da sincronizzare abbiano descrizione e prezzo compilati
Domande frequenti
Le domande che riceviamo più spesso, con risposte dirette.
Termini e definizioni
I termini tecnici usati nella documentazione e nel portale SIBIA, spiegati in modo semplice.
Non hai trovato quello che cercavi?
Scrivi all’assistenza descrivendo il problema: ti risponderemo nei giorni lavorativi.
