1. Obiettivi del documento

Questo documento ha lo scopo di dettagliare il funzionamento tecnico e funzionale del nostro connettore. Definisce il perimetro di 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 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

Pennylane è un software cloud per la contabilità e la gestione finanziaria. Questa integrazione consente di sincronizzare i dati di Pennylane con Agicap, supportando l'importazione di documenti aziendali e i workflow di Accounts Receivable.

2.1 Prerequisiti di accesso & credenziali

Piano: È necessario un piano Pennylane Essential o superiore per attivare l'integrazione.
Ruolo utente: L'utente deve avere almeno il ruolo di gestionnaire (Impostazioni azienda > Gestione team).

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 dal team di Assistenza Agicap (CST) sulla piattaforma Chift, utilizzando le credenziali fornite dall'amministratore Pennylane.

3. Informazioni generali

3.1 Chift

Agicap collabora con Chift per integrare ERP cloud come Pennylane.

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 le registrazioni contabili (giornale degli acquisti, prima nota) da Agicap verso l'ERP del cliente. I file di pagamento e gli estratti conto non sono coperti da Chift (vedi 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 dal team di Assistenza Agicap (CST).
Sicurezza: Chift agisce come livello sicuro di trasporto dati tra Pennylane 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.

4. Flussi & casi d'uso

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

Nome	Stato	Tipo di flusso	Descrizione	Limitazioni
Riconciliazione automatica delle fatture nell'ERP tramite esportazione della prima nota	🟡 In Beta con limitazioni	Agicap → ERP	Automatizza la sincronizzazione del piano dei conti e dei conti clienti/fornitori tra l'ERP e Agicap	Giu 2026: la riconciliazione automatica funziona solo quando le fatture sono state precedentemente importate dall'ERP in Agicap (tramite Documenti Aziendali). Quando le fatture hanno origine in Agicap e non sono state importate dall'ERP, la riconciliazione in Pennylane tramite esportazione della prima nota non viene attivata. Al momento, quando Chift non riesce a riconciliare una registrazione esportata, Agicap la mostra come un errore di esportazione: la registrazione è contrassegnata come non importata, con il messaggio "Chift cannot reconcile export". È prevista un'evoluzione per distinguere gli errori di esportazione da quelli di riconciliazione.
Importazione 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. L'importazione delle fatture in AR crea automaticamente i clienti con la coppia ragione sociale cliente/fornitore + codice cliente/fornitore → solo queste informazioni vengono recuperate e nessun indirizzo email viene aggiunto
Esportazione prima nota spese da Agicap	🟢 Disponibile	Agicap → ERP	Automatizza la creazione delle registrazioni di prima nota nell'ERP per le transazioni effettuate con il modulo spese in Agicap
Esportazione finanziamenti infragruppo da Agicap	🔴 Non disponibile	Agicap → ERP
Esportazione fatture AP da Agicap	🔴 Non disponibile	Agicap → ERP	Il caso d'uso per PDP deve essere precisato (per ERP francesi)
Esportazione previsioni da Agicap	🔴 Non disponibile	Agicap → ERP
Importazione beneficiari in Agicap	🔴 Non disponibile	ERP → Agicap	Alimenta la lista dei beneficiari di Agicap nel modulo pagamenti per evitare di doverli creare/aggiornare manualmente. + esigenza di sicurezza: evitare errori o modifiche fraudolente in Agicap
Importazione file di pagamento in Agicap	⚪ SFTP standard	ERP → Agicap	Sfrutta la connettività bancaria di Agicap per automatizzare il processo di pagamento e garantire maggiore sicurezza	Link al processo SFTP standard da applicare: qui
Importazione piano dei conti / codici clienti/fornitori in Agicap	🟢 Disponibile	ERP → Agicap		⚠️ Pennylane non ha un conto generico clienti/fornitori: ogni fornitore ha il proprio conto (es. 40100TOPSYS). In fase di esportazione della prima nota, il conto di contropartita potrebbe non essere compilato automaticamente e potrebbe essere necessario inserirlo manualmente.
Esportazione prima nota senza automatizzazione della riconciliazione TRY verso ERP	🟢 Disponibile	Agicap → ERP	Sfrutta il modulo di riconciliazione e prima nota di Agicap per automatizzare la creazione della prima nota	Viene esportato solo l'importo nella valuta principale. L'importo in valuta estera non viene inviato (Pennylane accetta o l'importo in valuta estera o il tasso di cambio, non entrambi).
Esportazione solleciti da Agicap AR	🔴 Non disponibile	Agicap → ERP
Esportazione investimenti finanziari da Agicap	🔴 Non disponibile	Agicap → ERP
Esportazione ordini di acquisto AP da Agicap	🔴 Non disponibile	Agicap → ERP	Il caso d'uso per PDP deve essere precisato (per ERP francesi)
Esportazione debiti da Agicap	🔴 Non disponibile	Agicap → ERP
Esportazione estratti conto da Agicap verso ERP	⚪ SFTP standard	Agicap → ERP	Automatizza la sincronizzazione del piano dei conti e dei conti clienti/fornitori tra l'ERP e Agicap	Link al processo SFTP standard da applicare: qui
Esportazione giornale degli acquisti da Agicap verso ERP	🟢 Disponibile	Agicap → ERP	Sfrutta l'OCR SIM di Agicap per digitalizzare le fatture fornitore e crearle nel giornale degli acquisti con il PDF associato	La sincronizzazione utilizza il modulo contabile di Pennylane (non il modulo di fatturazione). Per l'importazione della prima nota in Pennylane: le spese anticipate/charges constatés d’avance non vengono importate (27/02/2026). Le registrazioni esportate non possono essere modificate una volta esportate in Pennylane. I codici analitici vengono esportati solo se il piano analitico è identico in Agicap e Pennylane. Il piano analitico non viene sincronizzato automaticamente.
Importazione documenti aziendali in Agicap	🟡 Disponibile con limitazioni	ERP → Agicap	Alimenta TRY con transazioni in attesa. Alimenta AR con documenti aziendali (fatture, note di credito)	1. ⚠️ Vengono recuperati solo i giornali acquisti e vendite (no AN, prima nota o OD). 2. ⚠️ Una singola fattura non può avere più date previste → le fatture a pagamento rateale vengono importate con una sola data, quindi la tempistica della previsione TRY potrebbe essere errata. 3. ⚠️ Viene recuperato solo l'importo totale delle fatture parzialmente pagate (i pagamenti parziali sono ignorati) → gli importi residui sono sovrastimati, quindi gli importi previsti TRY sono gonfiati e il follow-up AR / DSO è impreciso. 4. ⚠️ Un documento eliminato o archiviato in Pennylane viene annullato in Agicap solo se la sua data fattura rientra nella finestra di sincronizzazione mobile di 12 mesi → i documenti più vecchi restano aperti in TRY e AR, quindi la previsione di tesoreria e il follow-up AR continuano a conteggiare fatture che non esistono più nell'ERP. L'annullamento avviene anche alla sincronizzazione successiva, non in tempo reale. Soluzione: chiedere al supporto di eliminare manualmente questi documenti, il connettore non li rimuove automaticamente. 5. ⚠️ I file PDF non vengono importati. 6. ⚠️ Le fatture ricevute via email in Pennylane vengono elaborate durante la notte, validate dal cliente, poi sincronizzate in Agicap la notte successiva → fino a 2 giorni di ritardo prima che appaiano in TRY e AR. Non è possibile una risincronizzazione manuale. 7. ⚠️ Un documento eliminato e ricreato in Pennylane riceve un nuovo ID → viene importato come nuovo documento in Agicap, senza collegamento con il precedente.

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

5. Domande frequenti (FAQ)

6. Appendici tecniche

Hai bisogno di aiuto o di ulteriori informazioni?

Contatta il supporto Agicap.

Pennylane - Chift