Unit4 koppelen met eConnect: ERPx via de Autopilot, ERP CR via SFTP en Financials via HTTPS.
Unit4 biedt in 2026 drie varianten met elk een eigen integratiemethode. Welke van toepassing is, hangt af van je Unit4-product.
Unit4 ERPx koppel je via de Autopilot. Inkoopfacturen worden automatisch ingelezen en geboekt. De configuratie wordt tijdens de implementatie met eConnect ingericht.
De Autopilot-configuratie verloopt via een stappenwizard in het eConnect-platform:
Let op: Verwerk eerst alle documenten via de oude route voordat je overschakelt. De configuratie van de koppeling wordt niet door de klant zelf uitgevoerd maar tijdens de implementatie.
Bij het boeken via Unit4 ERPx kan de melding [U4OK.JSON]: System.Int32 overflow optreden. Oorzaak: het factuurnummer is numeriek zo groot dat het buiten de limiet van een 32-bits geheel getal valt (maximaal 2.147.483.647). In dat deel van de Unit4-verwerking kan het systeem het nummer dan niet verwerken. Dit is een beperking in Unit4 zelf, niet in de eConnect-koppeling of in onze integratiecode.
In de praktijk zie je dit bij organisaties die zeer hoge reeksen gebruiken voor uitgaande factuurnummers (bijvoorbeeld waarden ruim boven de 2 miljard).
Wat kun je doen? De oplossing moet van Unit4 komen. Het factuurnummer in de bron-XML wijzigen via eConnect is geen haalbare workaround zonder risico voor je administratie en nummering. Unit4 is op de hoogte en werkt aan een structurele fix. Tot die tijd: escaleer naar je Unit4-beheerder of partner en gebruik zo nodig de XML-download vanuit het eConnect-platform (Postvak IN) om de case te onderbouwen.
Unit4 ERP CR (inclusief ERP7) en Unit4 Financials by Coda koppelen via SFTP respectievelijk HTTPS. Deze enterprise-koppelingen vereisen een contract en worden geconfigureerd door Unit4 of een Unit4-partner in samenwerking met eConnect.
De standaard integratiemethode voor Unit4 ERP CR en ERP7 is SFTP (Secure File Transfer Protocol). Meer informatie over hoe een SFTP-koppeling technisch wordt opgezet, vind je in het artikel SFTP-integratie.
In het verleden kon het voorkomen dat een factuur succesvol werd geboekt in Unit4 ERPx, maar de PDF-bijlage niet meekwam. De oorzaak lag in een connectiebreuk aan de Unit4-zijde waarbij de PDF werd gedropt. Sinds mei 2026 worden deze gevallen automatisch geretried, bevestigd door Platform & Integraties. In de meeste situaties zie je dit probleem dus niet meer terug.
Kom je toch nog een geval tegen waarin een factuur geboekt staat maar de PDF-bijlage ontbreekt, dan is dat een restgeval. Volg dan het diagnose-pad hieronder om te bepalen of het document echt is verloren of dat er een idempotente match speelt.
Tip: de factuur zelf kun je altijd downloaden vanuit het eConnect-platform (Postvak IN, drie puntjes bij het document). Stuur het document indien nodig handmatig door naar je Unit4-beheerder.
Unit4 ERPx kan inkoopfacturen zonder vervaldatum (DueDate) niet verwerken. Komt er een factuur binnen waarop dit veld ontbreekt, dan zet eConnect de DueDate standaard op de factuurdatum plus 30 dagen. Daarmee voorkomen we dat de boeking faalt op een formeel ontbrekend veld terwijl de inhoudelijke betalingstermijn in de praktijk meestal 30 dagen is.
Deze compensatie wordt per klant geconfigureerd als PrivateObject in de PSB. Wil je een andere standaardtermijn gebruiken, neem dan contact op met support; het is geen self-service-instelling.
Dit diagnose-pad geldt voor klachten als "de factuur staat op Booked in eConnect, maar ik zie hem niet in ERPx" of "de factuur lijkt nooit aangekomen, het Document Journal toont niets". Achtergrond: de Autopilot ↔ Unit4 ERPx-route is idempotent (match op factuurnummer plus klant plus leverancier). Bij een match roept eConnect ERPx niet opnieuw aan en wordt alleen een ontbrekende PDF geüpload, terwijl het platform toch Booked toont. Een leeg Document Journal voor de tweede aanbieding betekent dus meestal niet dat de factuur verloren is, maar dat de idempotente check is geactiveerd. Zie ook Autopilot — idempotente boeking.
De interpretatie van de statuslabels verschilt per koppeltype. Stel vast of het gaat om Autopilot (Unit4 ERPx), een andere PSB-route, een directe SOAP API of een SFTP-koppeling. Zie de statustabel in Autopilot — Boekingsstatussen voor de betekenis per koppeltype.
Noteer minimaal een van deze twee ID's voor het document:
documentId (afkomstig van de PSB), ofconsignmentId (afkomstig van het platform).Een van de twee is voldoende om het document in alle interne systemen op te zoeken.
Open het document in de interne Management API op documentId of consignmentId en bekijk de Events-tijdlijn. Hierin staat per stap welke handeling op het document is uitgevoerd: ontvangst, validatie, aanbieding aan ERPx, retries, idempotente match en PDF-upload. Voor SFTP-koppelingen is dit de enige plek waar de delivery-status zichtbaar is, omdat het softwarepakket via SFTP geen statusterugkoppeling geeft.
Zie je in de Events-tijdlijn dat eConnect de factuur als bestaand heeft herkend (zelfde factuurnummer, klant en leverancier) en alleen een PDF-upload heeft uitgevoerd? Dan is dit verwacht gedrag. De factuur stond al in ERPx van een eerdere aanbieding. Communiceer dit terug aan de klant; een escalatie is niet nodig.
Alleen wanneer de Events-tijdlijn geen sluitend beeld geeft, escaleer je naar het technische team. Geef daarbij minimaal mee:
documentId of consignmentId,partyId,Bij het verwerken van facturen via de ABWInvoice-transformatie (gebruikt bij Agresso/Unit4-integraties) kan de foutmelding [API400]: Initializing failed. Unhandled error occurred. optreden. De oorzaak is dat de transformatie is gebouwd op basis van de oorspronkelijke testdocumenten. Afwijkende documentvarianten (zoals free text-facturen) bevatten velden die ontbreken in de mapping, waardoor de transformatie faalt.
Er loopt een wijzigingsverzoek om de transformatie uit te breiden voor meerdere documenttypes. Als je deze foutmelding tegenkomt, neem dan contact op met support.
Bij Unit4-integraties met vreemde valuta (bijv. USD met koers) is de valutaconfiguratie de verantwoordelijkheid van de klant in de Unit4-omgeving. eConnect verwerkt wat het ERP aanlevert. Supportvragen over vreemde valuta verwijzen naar de klant-ERP-configuratie.
Foutmeldingen die beginnen met het prefix U4 komen uit Unit4 ERPx. De oplossing is vrijwel altijd aan de Unit4-kant te vinden. Je kunt het XML-bestand zelf downloaden vanaf het eConnect-platform (Postvak IN, drie puntjes bij het document) en doorsturen naar je Unit4-beheerder.
BTW-mapping: verschil inkomend en uitgaand
Bij inkomende facturen (Autopilot) verzorgt eConnect de BTW-mapping. Je configureert het schema via Platform > Autopilot > Verbinding > Boekingsschema > Beheer schemas > BTW. Bij uitgaande facturen doet eConnect geen BTW-mapping: Unit4 moet zelf de juiste UNCL5305-codes meegeven in de factuur-XML.
Dit is een generieke foutmelding die meerdere oorzaken kan hebben: een time-out bij Unit4, een factuur met meer dan 200 regels, factuurregels met een bedrag van € 0, of dubbele BTW-codes in het boekingsschema. Bied de factuur opnieuw aan via Postvak IN. Blijft de fout optreden, boek de factuur dan handmatig in ERPx en controleer het BTW-schema op dubbelingen.
De combinatie van leverancier en factuurnummer bestaat al in Unit4. Controleer of de factuur eerder is aangeboden (bijvoorbeeld via een andere route) en of de IDR het factuurnummer correct heeft herkend. Is de factuur daadwerkelijk dubbel, dan hoef je niets te doen. Is het een ander document met hetzelfde nummer, controleer dan de herkenning in het eConnect-platform.
De factuur-XML bevat een BTW-code die niet voorkomt in het Autopilot-boekingsschema. Dit gebeurt vooral bij facturen die via e-mail binnenkomen met een afwijkende of foutieve BTW-code. Voeg de ontbrekende mapping toe via Platform > Autopilot > Verbinding > Boekingsschema > Beheer schemas > BTW, of vraag de leverancier om de factuur via Peppol te versturen (waardoor standaard BTW-codes worden gebruikt).
De crediteur in Unit4 ERPx heeft geen betalingstermijn (betalingsvoorwaarde) ingesteld. eConnect geeft zelf geen vervaldatum mee aan Unit4. Stel de betalingstermijn in op de leverancierskaart in Unit4 ERPx.
De Dummy Crediteur in Unit4 is niet actief. Activeer de Dummy Crediteur in Unit4 ERPx en bied de facturen opnieuw aan.
Het factuurtotaal is € 0,00. Een factuur zonder bedrag kan niet in Unit4 worden geboekt.
De boekingsronde (boekingscyclus) in Unit4 ERPx is niet juist ingericht of niet actief voor de betreffende periode. Controleer en activeer de juiste boekingsronde in Unit4.
Het betalingskenmerk op de factuur is langer dan 27 posities, wat Unit4 niet accepteert. Als tijdelijke oplossing kun je de factuur als PDF insturen in plaats van via de automatische koppeling. Structureel moet de leverancier het betalingskenmerk inkorten.
De machine-to-machine (M2M) gebruiker waarmee eConnect inlogt op Unit4 heeft onvoldoende rechten of is gedeactiveerd. Laat de Unit4-beheerder de rechten van de M2M-eConnect gebruiker controleren en herstellen.
De factuur is geboekt op de Dummy Crediteur, maar een eerder document met hetzelfde factuurnummer staat daar al. Verwerk eerst de bestaande factuur op de Dummy Crediteur en bied de nieuwe factuur daarna opnieuw aan.
De routeringsconfiguratie in Unit4 ERPx mist een node voor de opgegeven workflow. Dit is een Unit4-zijdig probleem. Download de XML vanuit het eConnect-platform en stuur deze door naar je Unit4-beheerder om de routering aan te passen.
De bijgevoegde PDF bevat een ongeldig "data"-prefix in de Base64-data (bijvoorbeeld dataJVBERi0x... in plaats van JVBERi0x...). Bij facturen die via de IDR binnenkomen wordt dit automatisch gecorrigeerd. Bij facturen die rechtstreeks via Peppol binnenkomen kan dit probleem nog voorkomen. De bronafzender moet de XML corrigeren.
Unit4 ERPx koppel je via de Autopilot voor het automatisch ontvangen van inkoopfacturen. Unit4 ERP CR en ERP7 gebruiken SFTP, en Unit4 Financials by Coda koppelt via HTTPS. Beide laatste varianten vereisen een contract en worden geconfigureerd door Unit4 of een Unit4-partner.
Bij Unit4 ERPx wordt de configuratie tijdens de implementatie met eConnect ingericht, niet door de klant zelf. Bij Unit4 ERP CR en Financials by Coda wordt de configuratie uitgevoerd door Unit4 of een Unit4-partner in samenwerking met eConnect.
::e-accordion-item{value="item-3" header="Wat moet ik doen bij de foutmelding "Int32 overflow" bij grote factuurnummers?"} Dit is een beperking in Unit4 zelf wanneer het factuurnummer groter is dan 2.147.483.647. De oplossing moet van Unit4 komen. Escaleer naar je Unit4-beheerder of partner en gebruik zo nodig de XML-download vanuit het eConnect-platform om de case te onderbouwen. ::
Wil je Unit4 koppelen? Neem contact op met Unit4 of je Unit4-partner, of met eConnect sales voor een intakegesprek.
Start de koppeling