Foutmeldingen en oplossingen per ERP-pakket. Dit artikel behandelt pakketspecifieke fouten. Voor generieke API-, webhook- en connectiviteitsproblemen: zie Troubleshooting koppelingen.
Unit4 ERPx
Foutmeldingen met prefix U4 komen uit Unit4 ERPx. De oplossing is vrijwel altijd aan de softwarekant, niet bij eConnect. De klant kan het XML-bestand downloaden vanuit het platform en doorsturen naar de Unit4-beheerder.
API500: Unknown error occurred booking the invoiceTime-out, >200 regels, 0-regels, dubbele BTW-codesOpnieuw aanbieden; handmatig in ERPx; BTW-schema controlerenU4BadRequest: Invoice number already exists (3011/3010)Factuur al geregistreerdCheck of factuur 2x is aangeboden; IDR-herkenning controlerenAPI500: Could not find a VAT mapping 'P-XX9'Foutieve BTW-code in XMLLeverancier via Peppol laten sturen; mapping toevoegen in AutopilotU4BadRequest: BET.VOORW not validGeen betalingstermijn bij crediteurBetalingstermijn instellen in Unit4U4BadRequest: EI_AP_DEF_ACCOUNT not setDummy crediteur niet actiefDummy Crediteur activeren, facturen opnieuw aanbiedenU4BadRequest: Betaalbaar valutabedrag moet afwijken van 0Factuurtotaal is € 0,00Kan niet in Unit4 geboekt wordenU4Forbidden.JSON: User is not authorized (2030)M2M-eConnect gebruiker rechten kwijtRechten M2M-eConnect gebruiker terugzettenU4OK.JSON: System.Int32 overflowFactuurnummers die 2.147.483.647 overschrijdenUnit4-zijdig; Unit4 werkt aan oplossingEmbeddedDocumentBinaryObject Base64 "data" prefixBronafzender stuurt PDF met "data" prefix in Base64IDR verwijdert prefix automatisch; bij Peppol-facturen nog mogelijkDueDate-compensatie: Unit4 kan facturen zonder DueDate niet verwerken. eConnect zet standaard de DueDate op factuurdatum + 30 dagen wanneer dit veld ontbreekt. Dit wordt per klant geconfigureerd als PrivateObject in de PSB.
Factuur geboekt maar PDF-bijlage ontbreekt: eerdere connectiebreuken aan de Unit4-zijde waarbij de PDF werd gedropt, worden inmiddels geretried (bevestigd door Platform & Integraties, mei 2026). Restgevallen: zie het diagnose-pad hieronder.
Diagnose: factuur niet aangekomen in ERPx zonder foutmelding
Dit pad geldt voor klachten als "Booked in eConnect maar niet zichtbaar in ERPx" of "factuur lijkt nooit aangekomen, geen melding in Document Journal".
Achtergrond: de Autopilot -- Unit4 ERPx-route is idempotent (match op factuurnummer + klant + leverancier). Bij een match wordt ERPx niet opnieuw aangeroepen en alleen een ontbrekende PDF geupload, terwijl het platform toch Booked toont. Een leeg Document Journal voor de tweede aanbieding betekent dus niet dat de factuur verloren is, maar meestal dat de idempotente check is geactiveerd.
Stappen:
Stap 1: Identificeer het koppeltype
Bepaal het koppeltype van de ontvanger: Autopilot (Unit4 ERPx), andere PSB-route, directe SOAP API of SFTP. De interpretatie van de statuslabels verschilt per koppeltype.
Stap 2: Verzamel een document-ID
Verzamel een van de volgende ID's voor het document:
documentId (afkomstig van de PSB), ofconsignmentId (afkomstig van het platform).
Een van deze twee is voldoende om het document in alle interne systemen op te zoeken.
Stap 3: Raadpleeg Management API - Events (intern)
Open het document op documentId of consignmentId en raadpleeg de Events-tijdlijn. Hierin staat per stap welke handeling op het document is uitgevoerd (ontvangst, validatie, aanbieding aan ERPx, retries, idempotente match, PDF-upload). Voor SFTP-koppelingen is dit de enige plek waar de delivery-status zichtbaar is.
Stap 4: Idempotente match herkennen
Zie je in Events dat eConnect de factuur als bestaand heeft herkend (factuurnummer + klant + leverancier) en alleen een PDF-upload heeft gedaan? Dan is dit verwacht gedrag -- de factuur stond al in ERPx van een eerdere aanbieding. Geen escalatie nodig.
Stap 5: Escalatie (indien nodig)
Alleen als Events geen sluitend beeld geven: escaleer naar het technische team met minimaal:
documentId of consignmentId- ontvanger
partyId - koppeltype (Autopilot, andere PSB-route, SOAP, SFTP)
- klantnaam en ticketnummer
ABWInvoice (Agresso/Unit4)
De ABWInvoice-transformatie is gebouwd op basis van oorspronkelijke testdocumenten. Afwijkende documentvarianten (bijv. free text-facturen) kunnen falen met "API400: Initializing failed". Oplossing: wijzigingsverzoek bij Development voor transformatie-uitbreiding.
Business Central
Foutmeldingen met prefix BC komen uit Business Central. Weinig invloed vanuit eConnect; de klant moet de BC-configuratie controleren.
De prefix tussen blokhaken duidt het type respons aan dat eConnect van Business Central terugkreeg bij het boeken van de factuur:
[BC400] -- een door Business Central afgekeurde aanvraag (BC gaf een 400-achtige fout terug). Dit is vrijwel altijd een validatie- of tabelrelatie-fout in de BC-configuratie van de klant (bijv. een ontbrekende waarde in een gerelateerde tabel of een veld dat niet aan een BC-voorwaarde voldoet). De tekst direct na [BC400]: (zoals Internal_InvalidTableRelation of Application_FieldValidationException) benoemt de concrete BC-fout en wijst naar het te corrigeren veld of de tabel.[BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- vergelijkbare BC-zijdige responsen (afgekeurd verzoek, niet gevonden, rate limit).[API400] -- afgekeurd door de eConnect-API zelf, voor BC (bijv. een onjuiste connectie-instelling).
In alle BC-prefixgevallen ligt de oplossing aan de BC-zijde (configuratie van de klant); eConnect heeft hier weinig invloed.
Refresh token verlopen / invalid_grantLang geen factuur verstuurdSelf-service: koppeling verwijderen en opnieuw verbinden in BCAPI400: action 'booking' not supportedConnectie bevat "booking" i.p.v. "autobooking"Correcte waarde instellen via ManagementApiBCNotFound: PSBWebhookReceiver_ReceiveHookOude koppeling corruptTechSupport oude koppeling verwijderenBCTooManyRequestsBC API rate limit overschredenDocument doorgaans wel verwerkt; verwijs naar BC-partnerBCBadRequest: Transaction Type value (ECONNECT)Transactietype ontbreektBij installatie automatisch toegevoegd; bij oudere versies handmatigBCBadRequest: VAT Prod. Posting Group value (1)BTW-waarde ontbreekt in VAT Product Posting GroupWaarde toevoegen; VAT Mapping controlerenBC400: Internal_InvalidTableRelation -- VAT Prod. Posting Group value (1)BTW-waarde ontbreekt in tabel VAT Product Posting GroupWaarde toevoegen aan VAT Product Posting Group; VAT-configuratie van de koppeling controlerenBC400: Application_FieldValidationException -- Account type must be 'Posting' (G/L Account 3000 is 'Begin-Total')Het gebruikte grootboekrekeningnummer is een totaalregel (Begin-Total), geen boekbare rekeningEen boekbare grootboekrekening (Account type = Posting) gebruiken in het boekingsschema van de AutopilotBCNotFound: G-Account CodeG-rekeningnummer niet gekoppeld als bankrekeningG-rekening toevoegen bij leverancier in BCBadRequest Control 'DocAmount' is read-only (4PS)4PS-versie heeft velden read-only gemaakt"excludeAmounts": true via Management APIProperty 'Bank_Account_Code' does not exist (4PS BE)Belgische BC-omgeving mist dit veld"excludeBankAccountCode": true via Management APIAFAS
No entityID found for companyPostcodecontrole met KvK klopt niet (nevenvestiging)KvK op debiteurenkaart corrigerenFacturen als dubbeling gemarkeerdFactuurnummer + factuurdatum identiek bij verschillende leverancierseConnect-zijdig probleem; intern onderzoek nodigBTW-uitsplitsing niet overgenomen (Small Business)Beperking AFAS Small BusinessGeen oplossing aan eConnect-zijdeAllSolutions
Bedrijf-organisatie niet gevondenKvK/BTW/OIN mismatchIdentifiers controleren in beide systemenOrdernummer ontbreektAllSolutions Logistiek ondersteunt geen ordernummers op verkoopfacturenHandmatig toevoegen in eConnectBTW-foutenAfrondingsberekening AllSolutions incorrectAllSolutions moet dit oplossenReset koppeling--MBDRAF > company > eConnect > Edit > datum vandaag; dan VIMEVB of VIMEXB draaienExact Online
ForbiddenOnvoldoende rechten (MijnKantoor werkt niet)Volwaardige gebruiker met minimale rechten instelleninvalid_grant / No consent from userOAuth-consent verlopen of ingetrokkenOpnieuw consent verlenen in Exact OnlineDigitale brievenbus niet aangemaaktRechten-probleemHandmatig aanmaken: Mijn Exact > Mijn relatiegegevens > Digitale brievenbussenBestaat reeds: Digitale brievenbus; Ongeldig: DivisieVerkeerde administratie gekoppeldDivision nummers vergelijkenGenerieke ERP-stappen
Bij elk ERP-pakket zijn de volgende stappen van toepassing:
- Verbinding testen: alle pakketten vereisen poort 443 naar het eConnect-endpoint.
- Softwarekoppeling intrekken: Platform > Verbindingen > Sleutel intrekken > ook in de gekoppelde software verwijderen.
- Documenten opnieuw aanbieden: Postvak IN/UIT > drie puntjes > "API-download opnieuw aanbieden". Bij dubbele-markering eerst "Als origineel markeren".
Terug naar softwarekoppelingen