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 se i flussi proposti corrispondono alle esigenze della tua azienda.
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 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 tuo progetto.
2. Prerequisiti e Deploy
EBP è un software di contabilità aziendale fornito da EBP Informatique. Questa integrazione consente di sincronizzare i dati EBP con Agicap, supportando ambienti multi-entità e multi-valuta, pre-riconciliazione dei pagamenti e automazione avanzata.
Questa sezione descrive i prerequisiti per l'utilizzo del connettore.
2.1 Prerequisiti tecnici
L'integrazione è compatibile con installazioni EBP on-premise, inclusi EBP ospitati sul server del tuo integratore (spesso chiamato "cloud"), a condizione che sia possibile concedere accesso al server e a SQL. L'offerta cloud SaaS di EBP non è supportata.
Supportato ✅ | Non supportato ❌ |
• EBP Contabilità (Compta) on-premise, gamma Pro e PME, dalla versione 21.0 • EBP ospitato su server o VM dell'integratore, se è possibile concedere accesso a server e SQL | • Offerta cloud SaaS di EBP • Versioni EBP inferiori alla 21.0 |
La versione esatta viene confermata durante la fase di deploy con il tuo integratore EBP e il team tecnico Agicap.
2.2 Organizzazione del deploy & 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 del componente tecnico.
Il team tecnico della tua azienda: Per la configurazione, i test dei flussi e la messa in servizio.
Per funzionare, è necessaria l'installazione di un agente di collegamento sul tuo server EBP: Installazione del servizio IO Manager. Questo servizio è unico per cliente e la sua configurazione fa parte dell'onboarding del progetto.
2.3 Prerequisiti di configurazione
Ambiente EBP
Impostazioni regionali di Windows: la cultura di Windows deve essere impostata su fr-FR prima che il database EBP venga installato sul server.
Istanze SQL: tutte le aziende EBP di un progetto devono essere ospitate sulla stessa istanza SQL. Se le tue aziende sono distribuite su più istanze SQL, è necessario un progetto per ogni istanza.
Modello di database: un database SQL = una azienda EBP = una entità Agicap.
Contabilità ausiliaria: non richiesta. Senza contabilità ausiliaria, il connettore legge i conti generali invece dei conti terzi.
Prima della connessione: elimina i dati demo (fittizi) dal tuo account Agicap, così da non mescolarli con i dati sincronizzati da EBP.
Accesso al servizio iO
Antivirus: escludere le cartelle
C:\Program Files (x86)\Les Editions CoMPAGNoNSeC:\ProgramData\Les Editions CoMPAGNoNS(consigliato), o almeno ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe e updater.exe. Altrimenti l'antivirus può bloccare il servizio o i suoi aggiornamenti.Permessi sulle cartelle: l'account del 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. Altrimenti non si riavvia dopo un riavvio del server e i flussi si interrompono senza alcun errore (ad esempio, gli estratti conto non vengono più depositati).
3. Informazioni generali
Questa sezione descrive l'infrastruttura globale che supporta lo scambio dei 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 |
443 | Out | Gateway API Flowwa (PAPI) | |
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 di business (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 vengono 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 suoi 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 - es. 08:00 o 08:30 o 10:00 o 10:30…)
Public API : Per i documenti di business 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 cash-flow 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 (un database SQL = una azienda EBP = una entità Agicap).
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 dati e 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 quello ancora non pagato, non l'importo totale della fattura.
Le transazioni pre-abbinate in EBP appaiono in Agicap solo con il loro saldo aperto (non pagato).
4. Flussi & Casi d'uso
Di seguito le funzionalità disponibili tramite il connettore. Alcuni flussi sono contrassegnati come "Beta", il che significa che sono in fase di rilascio graduale o di test finale.
Nome | Stato | Tipo di flusso | Descrizione | Limitazioni |
Emissione PA (solo Francia) | 🔴 Non disponibile | |||
Ricezione PA (solo Francia) | 🔴 Non disponibile | |||
[DEPRECATO] Importa solo transazioni in attesa in Agicap | 🔴 Non disponibile | ERP → Agicap | Alimenta TRY con transazioni in attesa | DEPRECATO: flusso legacy OpenAPI, sostituito da "Importa documenti di business in Agicap" (Public API). Non utilizzare per nuove connessioni. Questa pagina verrà eliminata una volta che tutte le connessioni saranno migrate. |
Esporta riconciliazione in ERP tramite prima nota | 🔴 Non disponibile | |||
Esporta previsioni da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Importa documenti di business in Agicap | 🟢 Disponibile | ERP → Agicap | Alimenta TRY con transazioni in attesa, AR con fatture da pagare e da sollecitare + note di credito | PublicAPI: recupera solo i giornali di acquisto e vendita 1. Vengono sincronizzate solo le scritture abbinate dell'esercizio corrente e degli ultimi 6 mesi dell'esercizio precedente che soddisfano i criteri sopra indicati 2. Solo AN degli ultimi 4 esercizi possono essere recuperati (i documenti originali dell'esercizio corrente + se collegati a un AN fino a 4 anni) ⚠️ Non disponibile se si tratta di EBP Cloud, a meno che non sia ospitato sul server dell'integratore (in tal caso può essere trattato come on-premise). |
Esporta fatture AP da Agicap | 🔴 Non disponibile | Agicap → ERP | Use case per PDP da precisare (per ERP francesi) | |
Importa anagrafica clienti & contatti in Agicap | 🔴 Non disponibile | ERP → Agicap | Alimenta il modulo AR di Agicap con i dati clienti dall'ERP per evitare aggiornamenti manuali in Agicap | |
Esporta giornale acquisti da Agicap verso ERP | 🔴 Non disponibile | Agicap → ERP | Sfrutta Agicap SIM OCR per digitalizzare le fatture fornitore e crearle nel giornale acquisti con il PDF associato | |
Esporta solleciti da AR Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Importa beneficiari in Agicap | 🔴 Non disponibile | ERP → Agicap | Alimenta l'elenco dei beneficiari Agicap nel modulo di pagamento per evitare di doverli creare/aggiornare manualmente. + esigenza di sicurezza: evitare errori o modifiche fraudolente in Agicap | |
Importa Piano dei Conti / Codici cliente/fornitore in Agicap | 🔴 Non disponibile | ERP → Agicap | ||
Esporta giornale delle spese bancarie da Agicap | 🔴 Non disponibile | Agicap → ERP | Automatizza la creazione delle registrazioni di prima nota bancaria nell'ERP per le transazioni effettuate con il modulo spese in Agicap | |
Esporta estratti conto bancari da Agicap verso ERP | 🔴 Non disponibile | Agicap → ERP | Automatizza la sincronizzazione del piano dei conti e dei conti clienti/fornitori tra l'ERP e Agicap | |
Esporta finanziamenti infragruppo da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Esporta investimenti finanziari da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Importa file di pagamento in Agicap | 🔴 Non disponibile | ERP → Agicap | Sfrutta la connettività bancaria di Agicap per automatizzare il processo di pagamento e garantire una maggiore sicurezza | |
Esporta finanziamenti da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Esporta prima nota bancaria senza automatizzazione della riconciliazione TRY verso ERP | 🔴 Non disponibile | Agicap → ERP | Sfrutta il modulo di riconciliazione e prima nota bancaria di Agicap per automatizzare la creazione della prima nota bancaria + auto riconciliazione delle fatture AR/AP | |
Esporta ordini di acquisto AP da Agicap | 🔴 Non disponibile | Agicap → ERP | Il caso d'uso per PDP deve essere precisato (per ERP francesi) |
Nota: Per le funzionalità BETA, potrebbe essere necessario un tempo di implementazione 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 durante l'implementazione; sono possibili più sincronizzazioni giornaliere.
Cosa succede se un cliente desidera solo determinati 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 vengono considerati in Treasury?
Una transazione in attesa in Treasury interessata da un pagamento parziale verrà visualizzata direttamente con il suo importo rimanente.
Hai bisogno di aiuto o di maggiori informazioni?
Contatta l'assistenza Agicap.