Aiuto - Domande / Risposte


Integrazioni & API

Domande :

Tempolia propone diverse soluzioni per l'integrazione con il tuo software di contabilità, tutte riunite in « Strumenti > Esportazione fatture in contabilità ». Scegli il tuo software e Tempolia seleziona il formato adatto.

Schermata Tempolia: La pagina di esportazione contabile per scegliere perimetro e formato.
La pagina di esportazione contabile per scegliere perimetro e formato.

Il metodo standard è l'esportazione di file, CSV o TXT, contenenti le scritture contabili, come conti clienti 411, conti di ricavo 7xx e IVA, che puoi poi importare nel tuo sistema contabile.

Tempolia sviluppa inoltre attivamente integrazioni tramite API con i principali software contabili francesi, tra cui Fulll, Cegid Loop, ACD, Sage, Pennylane, MyUnisoft e Inqom. L'uso delle API permette il trasferimento automatico delle scritture, fatture, pagamenti e spese, verso il software contabile fin dall'emissione delle fatture, riducendo notevolmente il lavoro manuale. Alcune API permettono persino di recuperare durante la notte dati, come clienti e collaboratori, dal software contabile verso Tempolia. Sebbene l'API sia generalmente più efficiente, alcune possono talvolta essere piuttosto lente.

Schermata Tempolia: Integrazione contabile fatture a esportare.
Integrazione contabile fatture a esportare.

L'offerta Tempolia Enterprise include le nostre interconnessioni con le API dei software contabili.

Per utilizzare l'API Fulll, devi semplicemente contattarli per far attivare la tua API Fulll. Potrai quindi connetterti con le tue credenziali abituali Fulll da Tempolia ed effettuare le esportazioni senza alcuna altra configurazione. Per le altre API di esportazione in contabilità, occorre di solito seguire le indicazioni dell'editore del software contabile per creare una chiave API e una password affinché possiamo configurare l'accesso. In seguito potrai utilizzare l'API per l'esportazione in contabilità.

Schermata Tempolia: Integrazione contabile pagamenti a esportare.
Integrazione contabile pagamenti a esportare.

Puoi recuperare automaticamente la produzione del reparto paghe dal software Silae nell'ambito dell'offerta Enterprise.

Schermata Tempolia che mostra la pagina di import Silae e le corrispondenze della produzione sociale
La pagina di import Silae e le corrispondenze della produzione sociale.

Per quanto riguarda l'API Silae, puoi sottoscrivere la loro API REST destinata agli studi. Dovrai contattare Silae per ottenere le credenziali di accesso all'API e trasmettercele affinché possiamo integrarle nel nostro sistema. Nota: l'accesso alla loro API può essere fatturato separatamente da Silae, ma secondo le nostre informazioni l'API studio non è a pagamento per il nostro utilizzo, cioè livello 1 secondo la loro codifica. Per informazione, la documentazione dell'API Silae è disponibile su https://silae-api.document360.io/docs

Da parte nostra, chiamiamo le funzionalità della loro API per recuperare la produzione del tuo reparto paghe, per conoscere ciò che vuoi fatturare, a priori cedolini emessi, entrate e uscite. Poi effettuiamo una corrispondenza con le attività definite in Tempolia e per le quali hai configurato le tariffe di vendita.

Schermata Tempolia: I prezzi delle attività a quantità usati dopo l’importazione Silae.
I prezzi delle attività a quantità usati dopo l’importazione Silae.

Durante l'import, la corrispondenza dei dossier tra Silae e Tempolia avviene:

  • automaticamente se il codice cliente in Tempolia è identico al codice dossier in Silae
  • tramite il campo "Codice SILAE". Questo campo va compilato nella scheda "Caratteristiche parametrabili" delle schede clienti di Tempolia per indicare un codice dossier specifico in Silae. Può essere compilato manualmente o tramite import di un file CSV a 2 colonne: codice cliente in Tempolia e codice dossier in Silae.
Schermata Tempolia: Le corrispondenze dei codici vendita utilizzate durante l’importazione Silae.
Le corrispondenze dei codici vendita utilizzate durante l’importazione Silae.

Per procedere all'import:
Vai in « Strumenti > Import produzione sociale Silae » e indica l'intervallo di date sul quale vuoi recuperare la produzione Silae, nonché un collaboratore a cui saranno fittiziamente collegate le righe create.

Puoi inviare le tue fatture Factur-X sul sito Web Chorus Pro, che è la piattaforma statale per l'invio delle fatture.

Schermata Tempolia: L’elenco fatture e stati da controllare dopo un rifiuto Chorus Pro.
L’elenco fatture e stati da controllare dopo un rifiuto Chorus Pro.

A seconda della natura dei tuoi clienti, è possibile che il numero di impegno e il servizio codice sono obbligatori.
I messaggi di Chorus Pro non sono molto espliciti, bisogna guardare il nome del campo mancante e dedurre le informazioni mancanti:

Schermata Tempolia: Scarti Chorus Pro azioni PA sollecito.
Scarti Chorus Pro azioni PA sollecito.
  • Il messaggio "Impegno legale (FichierXml.SupplyChainTradeTransaction .ApplicableHeaderTradeAgreement .BuyerReference.value) è obbligatorio" significa che è necessario inserire il codice del servizio nella scheda Caratteristiche configurabili del Foglio aziendale della fattura.
  • Il messaggio "L'impegno legale (File Xml. SupplyChainTradeTransaction. ApplicableHeaderTradeAgreement.BuyerOrderReferencedDocument.IssuerAssignedID.value) è obbligatorio" significa che devi inserire il numero di impegno nella scheda Caratteristiche configurabili del Foglio aziendale della tua fattura.

Dopo aver modificato i tuoi dati, rigenera il PDF della tua fattura e inviarla nuovamente a Chorus Pro.

Schermata Tempolia: Scarti Chorus Pro storico PA errori.
Scarti Chorus Pro storico PA errori.

Tempolia espone i tempi consuntivi o previsionali di un collaboratore tramite un link di condivisione calendario ICS in sola lettura. Il formato ICS, chiamato anche iCal e regolato dalla RFC 5545, è un formato internazionale che permette ai calendari di scambiare informazioni; non va confuso con ICS, Identificativo Creditore SEPA, che identifica una società che emette addebiti.

Schermata Tempolia che mostra la scheda Calendario della scheda collaboratore con i link ICS
La scheda Calendario della scheda collaboratore con i link ICS.

Per recuperare l'URL ICS e aggiungerla alla tua agenda: vai in "Collaboratori > Collaboratori", modifica un collaboratore e apri la scheda "Calendario". Troverai due link: "Calendario ICS dei tempi consuntivi" e "Calendario ICS dei tempi previsionali". Puoi copiare questi link e usarli in Office 365 o Google Calendar tramite funzioni solitamente chiamate "Abbonarsi dal web" o "Altri calendari > Da URL".

Schermata Tempolia: Calendario collaboratore agenda Tempolia.
Calendario collaboratore agenda Tempolia.

Il flusso è in sola lettura: le modifiche si fanno esclusivamente in Tempolia. La frequenza di aggiornamento dipende da Outlook / Google e non è istantanea.

Nota: non è possibile fare l'inverso, cioè visualizzare dati di Office 365 o Google Calendar in Tempolia, perché questi calendari non hanno tutti i campi necessari per compilare i dati attesi in Tempolia.

Tempolia ha una partnership con il servizio di firma elettronica jesignexpert.com, destinato agli studi di commercialisti in Francia esclusivamente. Se sei idoneo, hai aperto un account presso di loro e utilizzi Tempolia Enterprise, puoi far firmare documenti PDF tramite jesignexpert.com restando nell'interfaccia di Tempolia. Per la configurazione, invia al supporto Tempolia lo shortcut e il secret della tua API Jesignexpert, ricevuti dopo la creazione del tuo account jesignexpert.com.

Schermata Tempolia che mostra l’elenco dei preventivi usato nel flusso di firma elettronica
L’elenco dei preventivi usato nel flusso di firma elettronica.

Una volta attivata l'interconnessione, puoi andare nella pagina « Strumenti > Firma documenti ». Carica il documento in formato PDF, ad esempio un preventivo, una lettera di incarico o un contratto, e inserisci le informazioni del firmatario: cognome, nome, indirizzo e-mail e numero di cellulare. Puoi indicare fino a 5 firmatari, e il numero di cellulare è necessario per ciascun firmatario perché serve alla procedura di firma.

Ogni firmatario riceve poi una notifica da jesignexpert.com contenente un link sicuro che permette di accedere al documento, consultarlo e firmarlo elettronicamente, senza creare un account. Una volta effettuata la firma, il documento è marcato temporalmente e certificato. Ricevi una notifica e-mail che conferma la firma e il documento firmato viene archiviato automaticamente nel tuo spazio.

Puoi anche seguire in qualsiasi momento lo stato di avanzamento delle richieste di firma dall'interfaccia di Tempolia, in particolare per sapere se un documento è in attesa, in corso di firma, rifiutato o terminato.

Schermata Tempolia: Firma elettronica lettere missione modulo.
Firma elettronica lettere missione modulo.

La firma elettronica è interamente dematerializzata e beneficia di un valore giuridico riconosciuto. Le firme saranno scritte in fondo all'ultima pagina del PDF; assicurati di lasciare uno spazio libero affinché il testo venga apposto. Ciò che fa fede è la giustificazione da parte di jesignexpert.com del processo di firma, e non la semplice apposizione dei testi di firma sul PDF.

Schermata Tempolia: Firma elettronica preventivi stato monitoraggio.
Firma elettronica preventivi stato monitoraggio.

Il server MCP di Tempolia, Model Context Protocol, permette a un'IA esterna, come Claude, ChatGPT, Gemini, Grok o qualsiasi altro agente compatibile MCP, di interagire direttamente con il database Tempolia per leggere o effettuare azioni, come creazione o modifica. L'utilizzo di un robot, di un agente automatizzato o dello scraping dell'interfaccia web non è autorizzato. Per qualsiasi uso automatizzato o guidato dalla tua IA dei dati presenti in Tempolia, è appropriato utilizzare l'MCP, che è l'interfaccia ufficiale affinché la tua IA possa manipolare i dati e realizzare azioni. Invece, per interagire con i dati Tempolia tramite un software terzo diverso da un motore di IA, è adatta la nostra API e sono necessari sviluppi.

L'utilizzo dell'MCP è indipendente da Tempolia AI: puoi connettere qualsiasi IA compatibile MCP al tuo server Tempolia per automatizzare azioni, interrogare i dati o integrare Tempolia nei tuoi agenti intelligenti.

Per utilizzare il server MCP di Tempolia, devi prima attivarlo, senza costi aggiuntivi: "Configurazione > Opzioni generali > scheda Varie". Una volta attivato, l'accesso al server MCP è disponibile per ogni collaboratore.

Schermata Tempolia che mostra le opzioni di attivazione MCP e Tempolia AI
Le opzioni di attivazione MCP e Tempolia AI.

Nella scheda del collaboratore, una nuova scheda "Tempolia AI" appare nella pagina "Collaboratori > Collaboratori > scheda collaboratore > scheda Tempolia AI".
In questa scheda sono indicati:
- l'URL personalizzato del server MCP
- la chiave di autenticazione
- informazioni esplicative
È presente anche una sezione specifica per l'utilizzo con Claude.

Schermata Tempolia che mostra la scheda Tempolia AI del collaboratore con l’URL MCP mascherato
La scheda Tempolia AI del collaboratore con l’URL MCP mascherato.

Ogni server MCP è associato a un collaboratore e ai suoi diritti. L'IA agisce quindi esattamente come quell'utente in Tempolia: tutte le regole di business e le restrizioni di diritti si applicano allo stesso modo dell'interfaccia web.

Schermata Tempolia: MCP Tempolia AI interfaccia chat.
MCP Tempolia AI interfaccia chat.

Per connettere la tua IA, è sufficiente dichiarare questo server MCP nel tuo strumento IA fornendo URL e chiave di autenticazione, secondo la procedura prevista dal LLM utilizzato. Una volta connessa, l'IA interroga automaticamente il server MCP per scoprire le funzionalità disponibili, strumenti, parametri e formati dati. Questa autodiscovery fa parte dello standard MCP e dipende dai diritti del collaboratore utilizzato.

L'MCP ti permette di interagire con il database Tempolia come se fossi connesso con un collaboratore specifico: i diritti, le restrizioni e le regole di business applicati nell'interfaccia si applicano anche tramite MCP. Devi quindi prestare attenzione ai diritti del profilo utilizzato.

Schermata Tempolia che mostra la scheda Tempolia AI che ricorda che MCP rispetta i diritti del collaboratore
La scheda Tempolia AI che ricorda che MCP rispetta i diritti del collaboratore.

Le azioni di lettura possono essere eseguite direttamente. Le azioni che modificano il database, creazione, modifica o cancellazione, richiedono una conferma prima dell'esecuzione quando sono chiamate da Tempolia AI.
Se utilizzi il server MCP tramite la tua IA, devi dare istruzioni alla tua IA affinché richieda la tua conferma e limiti le operazioni che desideri farle eseguire.

Schermata Tempolia: MCP azioni Tempolia AI chat.
MCP azioni Tempolia AI chat.
Dominio Operazioni possibili via MCP Esempi d'uso
SocietàRicerca, lettura, creazione, modifica, cancellazioneAggiornare un indirizzo, un IBAN, uno stato
ClientiRicerca, lettura, creazione, modifica, cancellazioneCorreggere un indirizzo, inserire un'e-mail di fatturazione, modificare parametri
PraticheRicerca, lettura, creazione, modifica, cancellazioneCreare una pratica, modificarne lo stato o i parametri
CollaboratoriRicerca, lettura, creazione, modifica, cancellazioneAggiornare gruppo, funzione o informazioni associate
ReferenzialiRicerca, lettura, creazione, modifica, cancellazioneGestire famiglie clienti, gruppi, settori o attività
CodiciRicerca e letturaRitrovare un codice vendita o un'attività fatturabile o non fatturabile
TempiRicerca, lettura, creazione, modifica, cancellazioneConsultare, correggere o inserire tempi consuntivi o previsionali
SpeseRicerca, lettura, creazione, modifica, cancellazioneConsultare o inserire spese sostenute o previsionali
FatturazioneRicerca e letturaConsultare fatture emesse e righe fattura
Fatture da convalidareRicerca, lettura, creazione, modifica, cancellazionePreparare o modificare fatture prima della convalida
PreventiviRicerca, lettura, creazione, modifica, cancellazioneConsultare o gestire preventivi e righe preventivo
PagamentiLetturaConsultare alcune informazioni legate ai pagamenti
RapportiLetturaLanciare stampe come scadenzario, saldi clienti o giornale vendite
Ricerca SIRET / SIRENLetturaRitrovare denominazione e indirizzo di una società

L'MCP è l'interfaccia ufficiale per interagire con Tempolia da una IA. Per qualsiasi richiesta, indica semplicemente il collaboratore interessato e l'azione desiderata.

Schermata Tempolia: MCP diritti login collaboratori.
MCP diritti login collaboratori.