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 Amministrativo, IT Manager), con l’obiettivo di:

Verificare che i flussi proposti corrispondano alle esigenze della tua azienda.
Confermare che il tuo ambiente tecnico soddisfi i prerequisiti di installazione.

⚠️ Metodologia di deployment: Il nostro approccio è pragmatico. Se, dopo l’analisi, i prerequisiti risultano convalidati, 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 deployment

2.1 Prerequisiti tecnici

Questa integrazione funziona solo per la FRANCIA.

Panoramica dell’integrazione Sage FRP 1000

Sage FRP 1000 è un software di contabilità aziendale fornito da Sage. Questa integrazione consente di sincronizzare i dati di Sage FRP 1000 con Agicap, supportando ambienti multi-entità e multi-valuta, pre-abbinamento dei pagamenti e automazione avanzata.

Versioni di Sage FRP 1000 supportate

Versioni supportate ✅	Versioni non supportate ❌
Sage FRP 1000 v8 e successive, indipendentemente dalla denominazione (v8, v9R2, versione 11 2025 R2 e versioni successive)	Versioni di Sage FRP 1000 precedenti alla v8

ℹ️ Sage ha cambiato la denominazione delle versioni nel tempo (v8, v9R2, poi "11 2025 R2"). Non esiste un limite superiore di versione. Qualsiasi versione dalla v8 in poi è inclusa. Il supporto delle versioni è indipendente dai prerequisiti server riportati di seguito (Windows Server 2016+, .NET 4.7.2+, SQL Server 2016+ per i documenti aziendali).

Collegamento di Sage FRP 1000 con Agicap

⚠️ Questa integrazione richiede l’installazione di un software sul server Sage che sarà gestita dal team tecnico Agicap ma richiede il coinvolgimento di IT/Integrator/Server Admin.

Prerequisiti della tua configurazione

Windows Server 2016 o superiore / Windows 8 o superiore
.NET framework 4.7.2 (o superiore) installato sul server SQL
Accesso amministratore al server che ospita i database Sage
Nome del server SQL e dei database Sage
(Opzionale) Utente SQL per Agicap con accesso in sola lettura
Devi generare una chiave API (Link impostazioni); il team tecnico Agicap ti guiderà nell’operazione
La sincronizzazione dei documenti aziendali è supportata a partire da SQL Server 2016
Antivirus: escludere le cartelle C:\Program Files (x86)\Les Editions CoMPAGNoNS e C:\ProgramData\Les Editions CoMPAGNoNS (consigliato), o almeno ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe e updater.exe. In caso contrario, l’antivirus può bloccare il servizio o i suoi aggiornamenti.
L’account di servizio iO deve avere accesso in lettura e scrittura a queste due cartelle e il diritto di eseguire msiexec.exe, utilizzato per gli aggiornamenti del servizio.
Tipo di avvio: il servizio iO ("iO Main Local Service") deve essere impostato su avvio Automatico nei servizi di Windows. In caso contrario, non si riavvia dopo un reboot del server e i flussi si interrompono senza alcun errore (ad esempio, gli estratti conto non vengono più depositati).

2.2 Organizzazione del deployment & prerequisiti di configurazione

L’installazione di questo connettore è un processo collaborativo che richiede l’intervento di tre attori:

I tuoi team: Per la convalida 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 esercizio.

Per funzionare, è necessaria l’installazione di un agente di collegamento sul server Sage (il servizio iO Manager). Questo servizio è unico per ogni cliente e la sua configurazione fa parte dell’onboarding del progetto. I prerequisiti di configurazione sono elencati nella sezione 2.1 sopra; gli accessi ai database necessari per ogni flusso sono descritti nella sezione 6.

⚠️ Il meeting di collegamento richiede la presenza di una persona con accesso amministratore ad Agicap e una persona con accesso all’ERP (server e database Sage FRP 1000).

3. Informazioni generali

Questa sezione descrive l’infrastruttura globale che supporta lo scambio dati.

Dominio / IP	Porta	Direzione	Commenti
.iomanager.app	443	Out	Comunicazione in uscita con iO per funzionalità contabili e di prima nota
IP servizio iO Manager: 20.19.239.7	443	In	Comunicazione in entrata con iO per chiamate di business. Utile solo per ERP SaaS
papi.lestudio.app	443	Out	Gateway API Flowwa (PAPI)
sb-papi-prod-00000001-iO.servicebus.windows.net e sb-papi-prod-00000001-iO-02.servicebus.windows.net	443	Out	Azure Service Bus, collegamento sicuro tra iO e il servizio locale

3.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 di dati senza soluzione di continuità tra i sistemi ERP dei nostri clienti e Agicap, supportando sia l’importazione di dati aziendali (ad esempio, fatture, note di credito, ordini di vendita) sia l’esportazione di file bancari da Agicap verso l’ERP.

Tutte le connessioni, configurazioni e flussi di dati sono impostati e mantenuti in stretta collaborazione tra i team tecnici di Agicap, 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 in modo permanente i tuoi dati contabili sui propri server, garantendo così la massima riservatezza.

3.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 cassa in attesa nel modulo Treasury (sincronizzate in Agicap solo durante un’ora intera o mezz’ora – ad 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.
Per ogni integrazione viene creata una connessione identificabile in Agicap (come integrazione di tesoreria o di business, a seconda del caso d’uso spiegato di seguito).
In Agicap, la connessione si sincronizza solo se ci sono nuovi dati o aggiornamenti da sincronizzare.
Gli orari e la frequenza di sincronizzazione vengono configurati durante l’implementazione: il connettore può sincronizzare quante volte al giorno necessario.

3.3 Supporto multi-entità e multi-valuta

Il connettore supporta configurazioni multi-entità e multi-valuta.
Agicap crea un conto per ogni entità (azienda) e per ogni valuta nel modulo Treasury.
Esempio: Società ALPHA (EUR), Società ALPHA (USD), Società BETA (EUR), Società BETA (USD).

3.4 Personalizzazioni dei dati e della sincronizzazione

È possibile applicare personalizzazioni per adattare etichette, date o importi dei dati importati. La fattibilità viene valutata dal team tecnico Agicap.
I dati sincronizzati possono essere filtrati secondo regole specifiche. La fattibilità viene valutata dal team tecnico Agicap.

3.5 Supporto pre-abbinamento (Pré-lettrage)

Il pre-abbinamento è supportato: l’importo visualizzato in Agicap è solo l’importo residuo non pagato, non l’importo totale della fattura.
Le transazioni pre-abbinate in Sage FRP 1000 appaiono in Agicap solo con il loro saldo aperto (non pagato).

4. Flussi & casi d’uso

Di seguito sono riportate le funzionalità disponibili tramite il connettore. Alcuni flussi sono contrassegnati come "Beta", il che significa che sono in fase di distribuzione graduale o di test finale.

Per maggiori dettagli tecnici su impostazioni aggiuntive e limitazioni per caso d’uso, consulta l’appendice

Nota: per le funzionalità BETA, potrebbe essere necessario un tempo di deployment aggiuntivo a seconda della complessità del tuo ambiente.

⚠️ Non è possibile alimentare il modulo Accounts Payable di Agicap con una connessione Sage FRP 1000.

5. Domande frequenti (FAQ)

Possono esserci più sincronizzazioni al giorno?

Sì, orari e frequenze di sincronizzazione sono configurabili durante l’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 è visualizzata accanto al nome della connessione in Banche & integrazioni. Log dettagliati e informazioni di tracciabilità possono essere richiesti all’Assistenza Agicap.

I pagamenti parziali sono presi in considerazione in Treasury?

Un’operazione inserita in Treasury interessata da un pagamento parziale verrà visualizzata direttamente con il suo importo rimanente.

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 metiers di Sage spostano il file in una directory media e creano il collegamento.

6. Appendici tecniche

6.1 Accesso al database per flusso

Flusso	Accesso al database Sage FRP 1000
Import (documenti aziendali, transazioni in attesa, piano dei conti)	Accesso SQL in sola lettura.
File di pagamento	L'unico flusso che scrive nel database, sia tramite un modulo firmato da Flowwa (DSM, installato dal tuo integratore) sia tramite uno script PowerShell.
Esportazione della prima nota	Il metodo di scrittura è in fase di finalizzazione. I prerequisiti correlati saranno condivisi con te prima della configurazione.

6.2 API & Sicurezza

I dati vengono inviati ad Agicap tramite API REST su HTTPS (crittografia TLS).
Flowwa gestisce solo la trasmissione dei dati e non memorizza in modo permanente i tuoi dati contabili.
Per i flussi di importazione, può essere creato per Agicap un utente SQL con accesso in sola lettura (opzionale, vedi 2.1).

Hai bisogno di aiuto o di maggiori informazioni?

Contatta il supporto Agicap.

Sage FRP1000