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 implementazione: 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 implementazione
Microsoft Dynamics 365 Business Central è una soluzione ERP cloud per piccole e medie imprese. Questa integrazione consente di sincronizzare i dati di Business Central con Agicap, supportando l'importazione di documenti aziendali e flussi di dati bidirezionali.
2.1 Prerequisiti di accesso & credenziali
Implementazione: Solo Business Central Online (Cloud) — Le installazioni On-Premise non sono supportate tramite questo connettore.
Ruolo utente: L'utente deve avere autorizzazioni da amministratore sull'ambiente Business Central per autorizzare l'integrazione.
Estensione Business Central: L'estensione Business Central richiesta dall'integrazione deve essere installata e aggiornata nel tuo ambiente (vedi la pagina di assistenza Chift qui sotto).
Per qualsiasi domanda relativa ai prerequisiti e/o al metodo di raccolta delle informazioni, Chift ha creato una pagina di assistenza dedicata per ogni ERP.
2.2 Organizzazione dell'implementazione
L'attivazione di questo connettore è semplice: la connessione viene creata e configurata da Agicap Support sulla piattaforma Chift, utilizzando le credenziali fornite dall'amministratore di Business Central.
2.3 Prerequisiti funzionali
Token API Agicap: Chift si collega ad Agicap tramite un token API Agicap. Un solo token è sufficiente per tutte le tue entità. Deve essere generato da un amministratore Agicap: un amministratore dell'organizzazione per la Public API (configurazione standard), oppure un amministratore dell'entità collegata per la Open API (connessioni precedenti).
Codice IVA (Tax key): Per le registrazioni esportate su Business Central, il codice IVA (TaxKey) impostato in Agicap deve corrispondere a un codice IVA esistente nel tuo ambiente Business Central (vedi la FAQ per un esempio).
Chiavi di abbinamento per l'esportazione della prima nota bancaria: Affinché l'esportazione della prima nota bancaria consenta anche l'abbinamento (lettera) delle relative fatture in Business Central, queste fatture devono essere state precedentemente importate in Agicap con le corrette chiavi di abbinamento: il numero fattura e la data di scadenza fattura (formato gg/mm/aaaa). Verifica questo prima di configurare la connessione.
Prima nota bancaria e transazioni in attesa: Se esporti la prima nota bancaria tramite Chift, non importare anche le transazioni in attesa (previsioni) tramite Chift.
Esportazione giornale acquisti: Il modulo Gestione Fatture Fornitore (SIM) o Spend di Agicap deve essere abilitato sull'entità.
3. Informazioni generali
3.1 Chift
Agicap collabora con Chift per integrarsi con una vasta gamma di ERP cloud e on-premise.
Cos'è Chift? Chift sviluppa connettori per diversi software aziendali, tutti accessibili tramite una singola API. Puoi pensare a Chift come a un "connettore per software aziendali." Agicap utilizza Chift come integratore per stabilire connessioni con una vasta gamma di ERP già coperti da Chift, invece di sviluppare un connettore interno per ciascuno.
Scopo & funzionamento: L'integrazione consente ad Agicap di (i) importare in modo sicuro i principali documenti aziendali dall'ERP del cliente nei moduli Agicap (Treasury, Accounts Receivable) e (ii) esportare registrazioni contabili (giornale acquisti, prima nota bancaria) da Agicap verso l'ERP del cliente. I file di pagamento e gli estratti conto non sono coperti da Chift (vedi la tabella dei casi d'uso).
Configurazione del progetto: Ogni integrazione cliente richiede una connessione dedicata sulla piattaforma Chift. La creazione e la configurazione iniziale della connessione sono gestite da Agicap Support.
Sicurezza: Chift agisce come livello sicuro di trasporto dati tra il tuo ERP e Agicap; i dati vengono scambiati tramite l'API unificata di Chift.
Consulta la lista completa delle integrazioni Chift.
3.2 Frequenza di sincronizzazione
La sincronizzazione dei dati tra Agicap e l'ERP tramite Chift avviene una volta al giorno in modo automatico.
Non sono disponibili trigger di sincronizzazione manuale.
Per ogni integrazione viene creata una connessione dedicata e identificabile.
4. Flussi & casi d'uso
Di seguito le funzionalità disponibili tramite il connettore. Alcuni flussi sono contrassegnati come "Beta", ovvero sono in fase di rilascio graduale o di test finale.
Nome | Stato | Tipo di flusso | Descrizione | Limitazioni |
Ricezione PA (solo Francia) | 🟡 Disponibile con limitazioni | se sono richiesti altri flussi oltre all'esportazione del giornale acquisti, come l'importazione di ordini d'acquisto o bolle di consegna in P2P, è necessario l'SFTP | ||
Emissione PA (solo Francia) | 🔴 Non disponibile | |||
Riconciliazione automatica delle fatture in ERP tramite esportazione della prima nota bancaria | 🔵 In Beta | Agicap → ERP | Sfrutta il modulo di riconciliazione e prima nota bancaria di Agicap per automatizzare la creazione della prima nota bancaria + la riconciliazione automatica delle fatture clienti/fornitori | Giu 2026: la riconciliazione automatica funziona solo quando le fatture sono state precedentemente importate dall'ERP in Agicap (tramite Business Documents). Le fatture originate in Agicap (non importate dall'ERP) non saranno riconciliate automaticamente. |
Esporta previsioni da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Esporta finanziamenti infragruppo da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Esporta giornale acquisti da Agicap verso ERP | 🔵 In Beta | Agicap → ERP | Sfrutta l'OCR SIM di Agicap per digitalizzare le fatture fornitore e crearle nel giornale acquisti con il relativo PDF associato | Solo informazioni a livello di intestazione |
Esporta prima nota bancaria senza automatizzazione della riconciliazione TRY verso ERP | 🔵 In Beta | Agicap → ERP | Sfrutta il modulo di riconciliazione e prima nota bancaria di Agicap per automatizzare la creazione della prima nota bancaria | |
Esporta estratti conto bancari da Agicap verso ERP | 🔴 Non disponibile | Agicap → ERP | Automatizza la sincronizzazione del piano dei conti e dei codici clienti/fornitori tra l'ERP e Agicap | |
Importa Business Docs in Agicap | 🔵 In Beta | ERP → Agicap | Alimenta TRY con transazioni in attesa, AR con fatture da pagare e da sollecitare + il PDF | |
Esporta ordini d'acquisto AP da Agicap | 🔴 Non disponibile | Agicap → ERP | Il caso d'uso per PDP deve essere precisato (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 fatture AP da Agicap | 🔴 Non disponibile | Agicap → ERP | Il caso d'uso per PDP deve essere precisato (per ERP francesi) | |
Importa beneficiari in Agicap | 🔴 Non disponibile | ERP → Agicap | Alimenta la lista beneficiari di Agicap nel modulo pagamenti per evitare di doverli creare/aggiornare manualmente. + esigenza di sicurezza: evitare errori o modifiche fraudolente in Agicap | |
Esporta solleciti da Agicap AR | 🔴 Non disponibile | Agicap → ERP | ||
Esporta investimenti finanziari da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Esporta prima nota bancaria Spend da Agicap | 🔵 In Beta | Agicap → ERP | Automatizza la creazione delle registrazioni di prima nota bancaria nell'ERP per le transazioni effettuate con il modulo Spend in Agicap | |
Esporta finanziamenti da Agicap | 🔴 Non disponibile | Agicap → ERP | ||
Importa piano dei conti / codici clienti/fornitori in Agicap | 🔵 In Beta | ERP → Agicap | ||
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 |
Nota: Per le funzionalità BETA, potrebbe essere necessario un tempo di implementazione aggiuntivo a seconda della complessità del tuo ambiente.
4.1 Importazione documenti aziendali: storico
Importazione iniziale: fatture con data fattura negli ultimi 6 mesi. Quando l'ERP consente a Chift di recuperare solo i record aggiornati, vengono importate anche tutte le fatture più vecchie ancora non pagate.
Aggiornamenti giornalieri: in tal caso, ogni giorno vengono recuperate le fatture create o aggiornate dall'ultima sincronizzazione. In caso contrario, Agicap rilegge ogni giorno una finestra mobile di fatture risalenti fino a 6 mesi prima della data di attivazione, con un limite massimo di 12 mesi.
4.2 Opzioni di esportazione pre-contabile (giornale acquisti / prima nota bancaria)
Quando il flusso di esportazione viene configurato, vengono impostate con te le seguenti opzioni:
Giornale: il giornale acquisti o la prima nota bancaria dell'entità in Business Central.
Conti transitori: se un conto utilizzato in Agicap non trova corrispondenza nel piano dei conti di Business Central, la registrazione esportata viene inserita in questi conti transitori.
Orario di sincronizzazione: espresso in UTC (es. 06:00 UTC = 07:00 in Francia in inverno).
Data di inizio: nessuna registrazione datata prima di questa data viene esportata.
Opzione bozza: esporta le registrazioni come bozze nell'ERP per una revisione finale. Non consigliato: suggeriamo di revisionare le registrazioni direttamente in Agicap.
Fatture senza allegato: scegli se includerle o meno tra le registrazioni esportate.
Motivo registrazione: titolo acquisto, nome fornitore o entrambi (consigliato).
Documenti giustificativi: ricevute e fatture da SIM o Spend possono essere allegate alle registrazioni esportate. I documenti Accounts Receivable non possono essere esportati tramite Chift.
Gli errori di esportazione, se presenti, sono visibili direttamente nel tuo account Agicap.
5. Domande frequenti (FAQ)
Business Central On-Premise è supportato?
No. Solo Business Central Online (Cloud) è supportato tramite questo connettore.
Cosa deve essere predisposto in Business Central prima della connessione?
Un utente con permessi da amministratore e l'estensione Business Central richiesta installata e aggiornata nel tuo ambiente.
Quale chiave fiscale (TaxKey) deve essere inserita in Agicap?
La chiave fiscale deve identificare un codice IVA del tuo ambiente Business Central. Puoi utilizzare sia l'ID del codice IVA sia il suo codice senza caratteri speciali (non sensibile alle maiuscole/minuscole). Ad esempio, per questo codice IVA in Business Central:
{ "id": "1a2b3c4d-0000-0000-0000-000000000000", "code": "DRITTLAND / EUST", "label": "EK: Drittland Einfuhrumsatzsteuer", "rate": 100}
la chiave fiscale in Agicap può essere 1a2b3c4d-0000-0000-0000-000000000000 oppure DRITTLANDEUST (o drittlandeust ).
Le mie fatture non vengono abbinate in Business Central dopo l'esportazione della prima nota bancaria. Perché?
Le fatture devono essere state importate in Agicap con le chiavi di abbinamento previste (numero fattura e data di scadenza fattura). Verifica che queste chiavi siano presenti sulle fatture importate.
Da quanto tempo vengono importate le fatture?
Fino a 6 mesi in base alla data della fattura al primo import (più le fatture non pagate più vecchie quando l'ERP lo supporta), poi aggiornamenti giornalieri su una finestra di 6-12 mesi.
Posso esportare la mia prima nota bancaria e importare le mie transazioni in attesa tramite Chift contemporaneamente?
No. Se la prima nota bancaria viene esportata tramite Chift, le transazioni in attesa non devono essere importate tramite Chift.
Posso avviare manualmente una sincronizzazione?
No. La sincronizzazione avviene automaticamente una volta al giorno, all'orario impostato durante la configurazione (in UTC).
Chi deve generare il token API di Agicap?
Un amministratore Agicap: un amministratore dell'organizzazione per la Public API, oppure un amministratore dell'entità collegata per la Open API. Un solo token è sufficiente per tutte le entità.
L'esportazione del giornale degli acquisti non è disponibile. Perché?
Il modulo Agicap Supplier Invoice Management (SIM) o Spend deve essere abilitato sull'entità.
Dove posso vedere gli errori di esportazione o importazione?
Gli errori sono visualizzati direttamente nel tuo account Agicap.
6. Appendici tecniche
Funzionalità Chift utilizzate dall'esportazione della prima nota bancaria
Sincronizzazione del piano dei conti e dei clienti/fornitori:
GET /chart-of-accounts,GET /clients,GET /suppliersCreazione delle registrazioni di prima nota bancaria:
POST /journal-entriesAbbinamento automatico (lettering):
POST /matching
Hai bisogno di aiuto o di maggiori informazioni?
Contatta l'assistenza Agicap.