Collegare Unit4 con eConnect: ERPx tramite Autopilot, ERP CR via SFTP e Financials via HTTPS.
Unit4 offre nel 2026 tre varianti, ciascuna con un proprio metodo di integrazione. Quale sia applicabile dipende dal Suo prodotto Unit4.
Collega Unit4 ERPx tramite l'Autopilot. Le fatture di acquisto vengono importate e registrate automaticamente. La configurazione viene impostata durante l'implementazione con eConnect.
La configurazione dell'Autopilot avviene tramite una procedura guidata a step nella piattaforma eConnect:
Attenzione: elabori prima tutti i documenti tramite il vecchio percorso prima di passare al nuovo. La configurazione del collegamento non viene eseguita dal cliente stesso, ma durante l'implementazione.
Durante la registrazione tramite Unit4 ERPx può comparire il messaggio [U4OK.JSON]: System.Int32 overflow. Causa: il numero di fattura è numericamente così elevato da superare il limite di un intero a 32 bit (massimo 2.147.483.647). In quella parte dell'elaborazione Unit4, il sistema non riesce a gestire il numero. Si tratta di una limitazione in Unit4 stesso, non nel collegamento eConnect o nel nostro codice di integrazione.
In pratica, ciò si verifica presso organizzazioni che utilizzano serie molto elevate per i numeri di fattura in uscita (ad esempio valori ben oltre i 2 miliardi).
Cosa può fare? La soluzione deve provenire da Unit4. Modificare il numero di fattura nell'XML di origine tramite eConnect non è una soluzione praticabile senza rischi per la Sua amministrazione e la numerazione. Unit4 ne è a conoscenza e sta lavorando a una correzione strutturale. Fino ad allora: escale al Suo amministratore o partner Unit4 e, se necessario, utilizzi il download XML dalla piattaforma eConnect (Posta in arrivo IN) per documentare il caso.
Unit4 ERP CR (incluso ERP7) e Unit4 Financials by Coda si collegano rispettivamente via SFTP e HTTPS. Questi collegamenti enterprise richiedono un contratto e vengono configurati da Unit4 o da un partner Unit4 in collaborazione con eConnect.
Il metodo di integrazione standard per Unit4 ERP CR ed ERP7 è SFTP (Secure File Transfer Protocol). Maggiori informazioni su come viene tecnicamente configurato un collegamento SFTP sono disponibili nell'articolo Integrazione SFTP.
In passato poteva accadere che una fattura venisse registrata correttamente in Unit4 ERPx, ma l'allegato PDF non venisse trasmesso. La causa era un'interruzione di connessione lato Unit4, con conseguente perdita del PDF. Da maggio 2026 questi casi vengono ritentati automaticamente, come confermato da Platform & Integraties. Nella maggior parte delle situazioni, questo problema non si presenta più.
Se dovesse comunque riscontrare un caso in cui la fattura risulta registrata ma manca l'allegato PDF, si tratta di un caso residuo. Segua allora il percorso di diagnosi qui sotto per stabilire se il documento è effettivamente andato perso o se è in gioco una corrispondenza idempotente.
Suggerimento: la fattura stessa può sempre essere scaricata dalla piattaforma eConnect (Posta in arrivo IN, tre puntini accanto al documento). Invii il documento manualmente al Suo amministratore Unit4, se necessario.
Unit4 ERPx non può elaborare fatture di acquisto senza data di scadenza (DueDate/PaymentDueDate); il campo non è obbligatorio nell'XML. Se arriva una fattura in cui questo campo manca, eConnect imposta la PaymentDueDate per impostazione predefinita sulla IssueDate (data della fattura) più 30 giorni. In questo modo evitiamo che la registrazione fallisca per un campo formalmente mancante, mentre il termine di pagamento effettivo è nella maggior parte dei casi di 30 giorni.
Si tratta di una Rule Based Enrichment (RBE) standard, configurata per cliente come PrivateObject nella PSB (tipicamente con Id unit4-setDueDate-30days). Se desidera un termine predefinito diverso, contatti il supporto; non è un'impostazione self-service.
Questo percorso di diagnosi vale per segnalazioni come "la fattura risulta Booked in eConnect, ma non la vedo in ERPx" o "la fattura sembra non essere mai arrivata, il Document Journal non mostra nulla". Contesto: la rotta Autopilot ↔ Unit4 ERPx è idempotente (corrispondenza su numero di fattura, cliente e fornitore). In caso di corrispondenza, eConnect non richiama ERPx e carica solo un PDF mancante, mentre la piattaforma mostra comunque Booked. Un Document Journal vuoto per la seconda presentazione di solito non significa che la fattura sia andata persa, ma che è stato attivato il controllo idempotente. Veda anche Autopilot — registrazione idempotente.
L'interpretazione delle etichette di stato varia in base al tipo di collegamento. Stabilisca se si tratta di Autopilot (Unit4 ERPx), di un'altra rotta PSB, di una SOAP API diretta o di un collegamento SFTP. Consulti la tabella degli stati in Autopilot — stati di registrazione per il significato per tipo di collegamento.
Annoti almeno uno di questi due ID per il documento:
documentId (proveniente dalla PSB), oppureconsignmentId (proveniente dalla piattaforma).Uno dei due è sufficiente per cercare il documento in tutti i sistemi interni.
Apra il documento nella Management API interna tramite documentId o consignmentId e visualizzi la timeline Events. Qui è indicato per ogni step quale operazione è stata eseguita sul documento: ricezione, validazione, presentazione a ERPx, retry, corrispondenza idempotente e upload PDF. Per i collegamenti SFTP, questo è l'unico punto in cui lo stato di consegna è visibile, poiché il pacchetto software via SFTP non restituisce alcun feedback di stato.
Nella timeline Events vede che eConnect ha riconosciuto la fattura come già esistente (stesso numero di fattura, cliente e fornitore) e ha eseguito solo un upload PDF? Allora si tratta di un comportamento atteso. La fattura era già presente in ERPx da una presentazione precedente. Comunichi questo al cliente; non è necessaria un'escalation.
Solo quando la timeline Events non fornisce un quadro completo, esegua l'escalation al team tecnico. Fornisca almeno:
documentId o consignmentId,partyId del destinatario,Durante l'elaborazione di fatture tramite la trasformazione ABWInvoice (utilizzata nelle integrazioni Agresso/Unit4) può comparire il messaggio di errore [API400]: Initializing failed. Unhandled error occurred. La causa è che la trasformazione è stata costruita sulla base dei documenti di test originali. Varianti di documento divergenti (come fatture free text) contengono campi assenti nella mapping, con conseguente fallimento della trasformazione.
È in corso una richiesta di modifica per estendere la trasformazione a più tipi di documento. Se riscontra questo messaggio di errore, contatti il supporto.
Per le integrazioni Unit4 con valuta estera (ad es. USD con tasso di cambio), la configurazione valutaria è responsabilità del cliente nell'ambiente Unit4. eConnect elabora ciò che l'ERP fornisce. Le richieste di supporto relative a valute estere vanno indirizzate alla configurazione ERP del cliente.
I messaggi di errore che iniziano con il prefisso U4 provengono da Unit4 ERPx. La soluzione si trova quasi sempre lato Unit4. Può scaricare autonomamente il file XML dalla piattaforma eConnect (Posta in arrivo IN, tre puntini accanto al documento) e inoltrarlo al Suo amministratore Unit4.
Mapping IVA: differenza tra entrata e uscita
Per le fatture in entrata (Autopilot), eConnect gestisce il mapping IVA. Configuri lo schema tramite Piattaforma > Autopilot > Collegamento > Schema di registrazione > GESTISCI SCHEMI > IVA. Per le fatture in uscita, eConnect non esegue mapping IVA: Unit4 deve fornire autonomamente i codici UNCL5305 corretti nell'XML della fattura.
Si tratta di un messaggio di errore generico che può avere più cause: un timeout presso Unit4, una fattura con più di 200 righe, righe di fattura con importo di € 0, o codici IVA duplicati nello schema di registrazione. Presenti nuovamente la fattura tramite Posta in arrivo IN. Se l'errore persiste, registri la fattura manualmente in ERPx e controlli lo schema IVA per duplicati.
La combinazione di fornitore e numero di fattura esiste già in Unit4. Verifichi se la fattura è stata presentata in precedenza (ad esempio tramite un altro percorso) e se l'IDR ha riconosciuto correttamente il numero di fattura. Se la fattura è effettivamente un duplicato, non deve fare nulla. Se si tratta di un documento diverso con lo stesso numero, controlli il riconoscimento nella piattaforma eConnect.
L'XML della fattura contiene un codice IVA che non compare nello schema di registrazione Autopilot. Ciò accade soprattutto con fatture ricevute via e-mail con codice IVA divergente o errato. Aggiunga il mapping mancante tramite Piattaforma > Autopilot > Collegamento > Schema di registrazione > GESTISCI SCHEMI > IVA, oppure chieda al fornitore di inviare la fattura tramite Peppol (con conseguente utilizzo di codici IVA standard).
Il creditore in Unit4 ERPx non ha impostato un termine di pagamento (condizione di pagamento). eConnect non trasmette autonomamente una data di scadenza a Unit4. Imposti il termine di pagamento nella scheda fornitore in Unit4 ERPx.
Il Dummy Crediteur in Unit4 non è attivo. Attivi il Dummy Crediteur in Unit4 ERPx e presenti nuovamente le fatture.
Il totale della fattura è € 0,00. Una fattura senza importo non può essere registrata in Unit4.
Il periodo contabile (boekingscyclus) in Unit4 ERPx non è configurato correttamente o non è attivo per il periodo interessato. Verifichi e attivi il periodo contabile corretto in Unit4.
Il riferimento di pagamento sulla fattura supera le 27 posizioni, cosa che Unit4 non accetta. Come soluzione temporanea, può inviare la fattura come PDF invece che tramite il collegamento automatico. A livello strutturale, il fornitore deve accorciare il riferimento di pagamento.
L'utente machine-to-machine (M2M) con cui eConnect accede a Unit4 ha diritti insufficienti o è stato disattivato. Chieda all'amministratore Unit4 di verificare e ripristinare i diritti dell'utente M2M-eConnect.
La fattura è registrata sul Dummy Crediteur, ma un documento precedente con lo stesso numero di fattura vi è già presente. Elabori prima la fattura esistente sul Dummy Crediteur e presenti nuovamente la nuova fattura.
La configurazione di routing in Unit4 ERPx manca di un nodo per il workflow indicato. Si tratta di un problema lato Unit4. Scarichi l'XML dalla piattaforma eConnect e lo inoltri al Suo amministratore Unit4 per adattare il routing.
Il PDF allegato contiene un prefisso "data" non valido nei dati Base64 (ad esempio dataJVBERi0x... invece di JVBERi0x...). Per le fatture ricevute tramite IDR, ciò viene corretto automaticamente. Per le fatture ricevute direttamente tramite Peppol, questo problema può ancora verificarsi. Il mittente di origine deve correggere l'XML.
Collega Unit4 ERPx tramite l'Autopilot per la ricezione automatica delle fatture di acquisto. Unit4 ERP CR ed ERP7 utilizzano SFTP, e Unit4 Financials by Coda si collega via HTTPS. Entrambe le ultime varianti richiedono un contratto e vengono configurate da Unit4 o da un partner Unit4.
Per Unit4 ERPx, la configurazione viene impostata durante l'implementazione con eConnect, non dal cliente stesso. Per Unit4 ERP CR e Financials by Coda, la configurazione viene eseguita da Unit4 o da un partner Unit4 in collaborazione con eConnect.
::e-accordion-item{value="item-3" header="Cosa devo fare in caso di messaggio di errore "Int32 overflow" con numeri di fattura elevati?"} Si tratta di una limitazione in Unit4 stesso quando il numero di fattura supera 2.147.483.647. La soluzione deve provenire da Unit4. Escale al Suo amministratore o partner Unit4 e, se necessario, utilizzi il download XML dalla piattaforma eConnect per documentare il caso. ::
Desidera collegare Unit4? Contatti Unit4 o il Suo partner Unit4, oppure eConnect sales per un colloquio di intake.
Avvia il collegamento