🔥 DOCUMENTO DA CONDIVIDERE CON I PROSPECT:Versione Google DocVersione PDF:File non disponibile
1. Obiettivi del documento
Questo documento ha lo scopo di dettagliare il funzionamento tecnico e funzionale del nostro connettore. Definisce il perimetro d'azione (cosa è coperto o meno) ed elenca i prerequisiti necessari per la sua implementazione.
Nota importante: I nostri team sono disponibili se hai bisogno di chiarimenti o ulteriori informazioni.
Come utilizzare questo documento? Si consiglia di consultare questo documento con tutte le persone competenti (CIO, CFO, Responsabile Contabile, IT Manager), con l'obiettivo di:
Verificare se i flussi proposti corrispondono alle esigenze aziendali.
Confermare che il tuo ambiente tecnico soddisfi i prerequisiti di installazione.
⚠️ Metodologia di Deploy:Il nostro approccio è pragmatico. Se, dopo l'analisi, i prerequisiti risultano validati, privilegeremo l'installazione del connettore nativo.Tuttavia, se per motivi tecnici o per una configurazione specifica il connettore non potesse essere attivato, passeremo senza problemi a un metodo alternativo tramite SFTP per garantire la continuità del progetto.
2. Prerequisiti e Deploy
Sage 100 è un software di contabilità aziendale fornito da Sage. Questa integrazione consente di sincronizzare i dati Sage 100 con Agicap, supportando ambienti multi-entità e multi-valuta, pre-riconciliazione dei pagamenti e automazione avanzata.
Questa integrazione funziona solo per la FRANCIA e questa sezione descrive i prerequisiti per l'utilizzo del connettore.
2.1 Prerequisiti tecnici
L'integrazione è compatibile con la maggior parte dell'ecosistema Sage 100.
Versioni supportate ✅ | Parzialmente supportate 🏗️ | Versioni non supportate ❌ |
• Sage 100 Comptabilité (v6 e successive) • Sage 100c • Sage 100c Comptabilité • Sage 100 i7 • Sage 100 Cloud • Sage 100 Entreprise • Sage 100 Suite comptable et financière | • Sage 100 Sage Partner Cloud (SPC, ospitato su Sage Cloud/Azure) → Beta per: documenti aziendali, esportazione giornale acquisti, esportazione giornale bancario & file di pagamento (non ancora testato) → ⚠️ Prerequisito: l'agente di esecuzione iO deve essere installato all'interno dell'ambiente SPC | • Altri prodotti fuori dalla suite Sage 100 • Sage 100 Gestion commerciale • Sage 100 Paie • Sage 100 Online, Sage Hébergé (cloud privato Sage) • Sage 100 Essential Comptabilité 7.00 cloud / Sage Online (non ancora disponibile) |
Come verificare la tua versione
Apri Sage 100
Clicca su "
?" poi "A proposito di…"
2.2 Organizzazione del deploy & prerequisiti di installazione
L'installazione di questo connettore è un processo collaborativo che richiede l'intervento di tre attori:
I tuoi team: Per la validazione degli accessi e la selezione dei conti da sincronizzare.
Il tuo Managed Service Provider: Per l'apertura degli accessi al server e l'installazione della componente tecnica.
Il team tecnico della tua azienda: Per la configurazione, i test dei flussi e la messa in servizio.
Per funzionare, è richiesta l'installazione di un agente di collegamento sul server Sage: Installazione del servizio IO Manager. Questo servizio è unico per cliente e la configurazione fa parte dell'onboarding del progetto IO Manager. Vedi Appendice per i prerequisiti dettagliati di installazione
3. Informazioni generali
Questa sezione descrive l'infrastruttura globale che supporta lo scambio dati.
2.1 Flowwa
Agicap collabora con Flowwa e la sua piattaforma IO Manager per integrare ERP on-premise come Sage 100, Sage FRP 1000 ed EBP (non quelli cloud). Questa partnership consente scambi dati fluidi tra i sistemi ERP dei nostri clienti e Agicap, supportando sia l'importazione di dati aziendali (es. fatture, note di credito, ordini clienti) sia l'esportazione di file bancari da Agicap verso l'ERP.
Tutte le connessioni, configurazioni e flussi dati sono impostati e mantenuti in stretta collaborazione tra i team tecnici di Agicap (CS Tech & PKM), i nostri clienti e Flowwa come fornitore di integrazione.
Cos'è Flowwa? È una piattaforma di integrazione dati (iPaaS) specializzata nell'interconnessione di software SaaS ed ERP.
Sicurezza: Flowwa garantisce il trasporto sicuro dei dati senza memorizzare permanentemente i dati contabili sui propri server, garantendo così la massima riservatezza.
2.2 Frequenza di sincronizzazione
I dati raccolti tramite IO Manager vengono inviati alle API di Agicap in tempo reale subito dopo ogni recupero dati da parte dell'‘IO Manager Agent’:
Open API : Per le transazioni di tesoreria in attesa nel modulo Treasury (sincronizzate in Agicap solo durante un'ora intera o mezz'ora - es. 08:00 o 08:30 o 10:00 o 10:30…)
Public API : Per i documenti aziendali nel modulo Accounts Receivable
I flussi di import/export sono sicuri: Flowwa non memorizza né visualizza i dati dei clienti, si occupa solo della trasmissione tramite la piattaforma IO Manager.
In Agicap, la connessione si sincronizzerà solo se ci sono nuovi dati o aggiornamenti da sincronizzare.
4. Flussi & Casi d'uso
Ecco le funzionalità disponibili tramite il connettore. Alcuni flussi sono contrassegnati come "Beta", cioè in fase di distribuzione graduale o test finale.
Per maggiori dettagli tecnici su impostazioni aggiuntive e limitazioni per caso d'uso, vedi appendice
[TABELLA DEI FLUSSI E CASI D'USO - struttura HTML invariata]
Nota: Per le funzionalità BETA, potrebbe essere necessario un tempo di deploy aggiuntivo a seconda della complessità del tuo ambiente
5. Domande frequenti (FAQ)
Possono esserci più sincronizzazioni al giorno?
Sì, orari e frequenze di sincronizzazione sono configurabili in fase di implementazione; sono possibili più sincronizzazioni giornaliere.
Cosa succede se un cliente vuole solo alcuni conti o giornali?
Durante l'implementazione, il team tecnico può impostare filtri per includere/escludere conti e giornali filtrati.
Dove posso vedere lo stato delle sincronizzazioni?
La data dell'ultima sincronizzazione sarà indicata accanto al nome della connessione nella scheda Stato sincronizzazione Banche & Integrazioni e i log e le informazioni di tracciabilità sono accessibili solo dal supporto Agicap.
I pagamenti parziali sono considerati in Tesoreria?
Un'operazione inserita in Tesoreria impattata da un pagamento parziale verrà visualizzata direttamente con il suo importo residuo.
Come vengono sincronizzati i pdf su Sage?
Il file viene caricato da Flowwa in una cartella temporanea. Il percorso del file viene aggiornato in Sage. Gli objets métiers di Sage spostano il file in una directory media e creano il collegamento.
6. Appendici tecniche
Prerequisiti di installazione
Prerequisiti di installazione
Prima di procedere con la configurazione della connessione Sage 100, verifica e valida i seguenti elementi:
Sistema operativo: Windows Server 2016 (o superiore) o Windows 8 (o superiore).
Gestione database: SQL Server Management Studio (SSMS) deve essere installato sul server Sage 100.
Framework: .NET Framework versione 4.7.2 (o superiore) deve essere installato sul SQL Server.
Versione SQL Server: Versione minima 2016 (versione 13.X).
Componenti Sage: Il servizio "Sage 100 Objets Métiers" deve essere installato nell'ambiente Sage 100.
Permessi: È richiesto accesso data writer per i casi d'uso di scrittura giornale.
Note sull'accesso al servizio iO
L'implementazione del connettore prevede l'installazione di un servizio Windows che legge e scrive nei database Sage 100. Devi assicurarti che questo servizio abbia permessi sufficienti sulle cartelle e sui database a cui deve accedere.
Se il servizio iO non viene eseguito sotto l'account Local System, deve essere creato un account Windows dedicato con permessi di lettura/scrittura sui database SQL Sage 100 rilevanti.
Questo account deve essere configurato:
Come login SQL Server.
Su tutte le istanze SQL che potrebbero essere utilizzate dai plugin che si basano su Sage 100.
Se il server che ospita il servizio iO è diverso dal server SQL:
L'account di servizio deve essere un Account di Dominio.
Deve avere le autorizzazioni appropriate sull'istanza SQL remota
Raccolta & Filtraggio dati
Il servizio IO Manager interroga regolarmente l'ERP del cliente per nuovi dati o aggiornamenti.
La frequenza e la pianificazione di queste interrogazioni possono essere configurate per progetto in IO Manager.
Possono essere applicati filtri per limitare la raccolta dati per giornali o conti generali direttamente in IO Manager.
Un recupero specifico per anno fiscale può essere impostato direttamente in IO Manager.
Informazioni generali su flussi dati, sicurezza, campi dati
Flusso di sincronizzazione dati
1️⃣ Un'attività pianificata avvia il servizio connettore Sage.
2️⃣ Il servizio interroga il database Sage per tutte le scritture contabili non riconciliate relative a fatture clienti e fornitori chiuse.
3️⃣ Il servizio chiama l'API Agicap per creare, eliminare o aggiornare le scritture secondo necessità.
Personalizzazioni dati e sincronizzazione
È possibile applicare personalizzazioni Agicap per adattare motivi, date o importi dei dati importati (la fattibilità deve essere valutata dal team tecnico Agicap).
I dati sincronizzati possono essere filtrati secondo regole specifiche (la fattibilità deve essere valutata dal team tecnico Agicap).
API & Sicurezza
REST API su HTTPS (crittografia TLS)
Rate limiting: 100 richieste/min/utente; oltre questo limite viene restituito un errore HTTP 429; l'infrastruttura può supportare oltre 500k richieste da più di 150 utenti in poche ore
Autenticazione: token dall'interfaccia Agicap; usato nell'autorizzazione API (non nell'header)
Nessun rischio di SQL/code injection: solo input JSON; oggetti rigorosamente formattati
Tabelle database utilizzate: F_ECRITUREC, F_COMPTET, F_COMPTEG, F_JOURNAUX
Supporto multi-entità e multi-valuta
Supporta configurazioni multi-entità e multi-valuta. Agicap crea un conto per ogni entità (azienda) per valuta nel modulo Treasury.
Esempio:
Società ALPHA (EUR), Società ALPHA (USD)
Società BETA (EUR), Società BETA (USD)
Campi dati & Gestione date
Logica date Sage 100
Data di fatturazione
Combinazione: JM_date (mese/anno) + EC_jour (giorno)
Esempio:**F_ECRITUREC_JM_Date = 2023-11-01F_ECRITUREC_EC_Jour = 8**→ DataFatturazione: 2023-11-08
Data di pagamento
Se riconciliata: usa il campo EC_Echeance
Se riconciliata e EC_Echeance è vuoto: fallback su Data di fatturazione (JM_date + EC_jour)
Se non riconciliata: usa Data di fatturazione
Dettagli per casi d'uso
Dettagli per casi d'uso
Esportazione file bancari su Sage 100
Questo connettore consente ai clienti di utilizzare Agicap come fonte dati per esportare file bancari nel proprio ERP.
💡
Esportazione automatica dei file bancari raccolti in Agicap in una cartella designata sul server Sage 100.
I file NON saranno importati automaticamente in Sage 100; è richiesto l'import manuale.
Qualsiasi file bancario disponibile tramite la Public API di Agicap è idoneo.
Per saperne di più su questa funzionalità, consulta:
Il cliente deve comunque importare manualmente il file esportato nel proprio ERP. Questo connettore può solo trasferire il file in una cartella designata sul server del cliente ma non avvia il processo di importazione nell'ERP.
Importazione piano dei conti (TRY, AR)
Impostazioni aggiuntive
IO
⚠️ è necessario compilare la fonte nella scheda “documenti aziendali / Engagés”
Spuntare la voce “attivo” su “Conti Fornitori” e “Conti Generali”