Foutmeldingen en oplossingen per ERP-pakket. Dit artikel behandelt pakketspecifieke fouten. Voor generieke API-, webhook- en connectiviteitsproblemen: zie Troubleshooting koppelingen.

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.

JSON-payload richting Unit4/ERPx is niet opvraagbaar. De JSON die eConnect naar Unit4/ERPx post wordt niet gelogd en is daardoor niet zelf op te halen — niet via een API-endpoint en niet via support. Handmatige reconstructie wordt niet ondersteund. Voor diagnose of verificatie van factuur-data verwijst support de klant naar het downloadbare XML-bestand uit het platform.

DueDate-compensatie: Unit4 kan facturen zonder DueDate/PaymentDueDate niet verwerken (veld is in de XML niet verplicht). eConnect zet standaard de PaymentDueDate op IssueDate (factuurdatum) + 30 dagen wanneer dit veld ontbreekt. Dit is een standaard Rule Based Enrichment, per klant geconfigureerd als PrivateObject in de PSB (typisch Id unit4-setDueDate-30days).

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.

UBW is de klassieke Agresso/UBW-naam; binnen eConnect gebruiken we deze als zoekalias naast Unit4 ERPx, waar deze doorzetting speelt.

Symptoom: een inkomende factuur (vaak niet-Peppol) is handmatig gemaild naar @trust.econnect.eu, is zichtbaar in het platform, maar staat (nog) niet in UBW/Agresso of het aangesloten financiele pakket. Zie ook Email Receiver voor de instroom via dit adres.

Maak eerst dit onderscheid, voordat je escaleert:

1. Tijdelijke batch- of doorzettingsvertraging: het document staat correct in het platform, maar het automatische ophaal- of boekingsproces van de klant moet nog draaien of is net bezig. Dit lost meestal zichzelf op; er is geen storing.
2. Blijvend niet aangekomen: na de verwachte run is de factuur nog steeds afwezig. Ga dan verder met Diagnose: factuur niet aangekomen in ERPx zonder foutmelding hieronder (koppeltype, documentId/consignmentId, Events, idempotentie tussen Autopilot en ERPx).

Bij een verse melding:

1. Bevestig de zichtbaarheid en status van de factuur in het platform.
2. Vraag naar het koppeltype of ERP-pakket (UBW/Agresso, Unit4 ERPx via Autopilot, SFTP/PSB, ...) en of het automatische proces vandaag al heeft gedraaid.
3. Heeft het proces nog niet gedraaid of loopt het net? Wacht dan kort af en bevestig na de run. Escaleer niet voortijdig.
4. Heeft het proces wel gedraaid en is de factuur blijvend afwezig? Verzamel de IDs en volg het diagnose-pad hieronder.

Er is geen vaste SLA in uren tussen het insturen via de Email Receiver en de verwerking in UBW/ERPx.

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.

Eerst dit controleren bij een Unit4-partner met meerdere facturen:

0. Delivered-only, geen journal: status Delivered/Ontvangen in Postvak IN met 0 hits in Document Journals betekent dat er nog geen Autopilot-boekingspoging (Booked/Booking failed) heeft plaatsgevonden. Bied de factuur eerst opnieuw aan de gekoppelde software aan; start pas daarna een Events-onderzoek. Zie Autopilot -- Document Journals.
1. Partijen scheiden: ontvangende klant (ERPx-gebruiker) is niet dezelfde als de leverancier op de factuur, en ook niet dezelfde als een eventuele tussenpartij op een bijgevoegde log.
2. Juiste log of document: controleer of de bijlage of het eConnect-log het geclaimde document is (factuurnummer, leverancier naar ontvanger). Een verkeerd log is een ander document; start daarop geen ERPx-onderzoek.
3. Kenmerk per geclaimde factuur: minstens het factuurnummer, bij voorkeur ook documentId of consignmentId. Meerdere ontbrekende factuurnummers zijn aparte documenten; Booked op factuur A dekt factuur B niet.
4. Booked plus duplicaatfout (bijvoorbeeld invoice number already exists, of na heraanbieding): vaak is hetzelfde factuurnummer opnieuw verstuurd. Het platform kan Booked tonen op de eerdere boeking; dat is geen bewijs dat een ander factuurnummer in ERPx staat. Bevestig dit via Events (stap 3 hieronder) of een bestaande ERPx-registratie.

Stappen:

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.

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.

Opzoekvolgorde identifiers in de factuur: 1. BTW, 2. KvK, 3. IBAN. Mapping naar BC API-velden: BTW naar VAT_Registration_No, KvK naar Registration_Number, IBAN naar Vendor Bank Account No. Leverancier niet gevonden: eConnect maakt geen leverancier aan; de factuur valt uit (typisch [API400] Could not retrieve vendor... / vendor ids).

Na herkenning van de leverancier worden bankrekeningen uit de factuur gecontroleerd tegen de Vendor Bank Accounts van die leverancier, inclusief G-rekeningen die via de IDR-extensie zijn meegegeven. Zie G-Account Code in de tabel hieronder.

De suffix .JSON (bijv. [BCNotFound].JSON) ontstaat doordat de koppelcode een JSON-respons verwacht, maar Business Central bij sommige 404-foutmeldingen een HTML-pagina terugstuurt in plaats van JSON. Die HTML kan niet naar JSON geparsed worden -- vandaar het .JSON-deel in de foutmelding. De onderliggende oorzaak is hetzelfde als bij een gewone [BCNotFound].

[BCNotFound] heeft doorgaans twee oorzaken:

1. De opgegeven URL van de BC-omgeving klopt niet.
2. De webservices die de koppeling nodig heeft, zijn niet gepubliceerd in de omgeving.

Voor uitgaand (facturen versturen) zijn de webservices meestal geen probleem: de eConnect-extensie publiceert die zelf. Voor inkomend kan de klant de extensie installeren om de webservices te publiceren, of de webservices handmatig publiceren.

Specifiek bij DataBalk-klanten geldt een derde oorzaak: zij koppelen de twee Lines-webservices PSBPurchaseOrderLines en PSBPurchaseInvoiceLines niet aan de standaardpagina's 54 en 55, maar aan maatwerkpagina's. Worden deze webservices toch aan de standaardpagina's gekoppeld, dan volgt een 404-respons bij het aanroepen.

De AFAS-koppeling werkt per administratie en per omgeving. Ontvangst zet de XML 1:1 door naar de gekoppelde AFAS-administratie. Faalt slechts één administratie terwijl andere administraties wel goed gaan, dan is dit zelden een organisatiebrede Peppol-ontvangstfout, maar meestal een admin-specifieke koppeling of doorzetting.

Controleer bij een melding in deze volgorde:

1. Scope: welke exacte AFAS-administratie (naam of ID) faalt? Gaan andere administraties wel goed?
2. Bewijs: minimaal één factuurnummer (met factuurdatum) dat volgens de klant in AFAS ontbreekt.
3. Postvak IN-check (zelfde organisatie):
   • Staat de factuur niet in Postvak IN? Dan zit het probleem eerder in de ontvangst, het Peppol-kanaal of het e-mailkanaal, niet in de AFAS-koppeling. Zie inkomende facturen.
   • Staat de factuur wel in Postvak IN maar niet in AFAS? Dan gaat het om de downstream-koppeling of doorzetting naar die administratie.
4. Verbinding: elke AFAS-omgeving heeft eigen verbindingssleutels. Controleer of de falende administratie in de juiste omgeving hangt en of de eConnect-sleutels voor die omgeving in AFAS actief zijn.
5. Platformactie (als het document wel in Postvak IN staat): controleer de status en gebruik "API-download opnieuw aanbieden"; staat de factuur als dubbel gemarkeerd, kies dan eerst "Als origineel markeren" (zie generieke ERP-stappen).

De bekende AFAS-foutregels hierboven (entityID, dubbeling, Small Business BTW, BE-0208 met punten) dekken dit scenario niet: dit is een admin-scope ontvangstdiagnose zonder vaste foutcode.

Bekende storing? Check eerst status.exact.com op actuele Exact-storingen -- los van de eigen eConnect-statuspagina (support.econnect.eu/status/). Een storing bij Exact zelf (bijv. Exact Online, Exact API) verklaart soms fouten die niet aan de eConnect-koppeling liggen.

Koppeling: SOAP-enterprise, alleen ontvangen (inkoop). Setup: ECI Inventive koppelen.

Twee oorzaken, niet door elkaar halen:

1. eConnect-platformverstoring: bijvoorbeeld PDF-bijlagen die niet meegeleverd worden. Controleer de factuurstatus in eConnect Postvak IN.
2. Eigen Payload-validatiefout aan de Inventive-zijde: valt buiten de scope van eConnect-support. De Inventive-beheerder onderzoekt dit.

Status "verwerkt" in eConnect Postvak IN betekent dat de factuur correct is afgeleverd door eConnect. Ontbreekt de factuur daarna nog in Inventive, controleer dan eerst de Inventive-payload/import (batchjobs), niet opnieuw de eConnect-ontvangst.

Bij elk ERP-pakket zijn de volgende stappen van toepassing:

1. Verbinding testen: alle pakketten vereisen poort 443 naar het eConnect-endpoint.
2. Softwarekoppeling intrekken: Platform > Verbindingen > Sleutel intrekken > ook in de gekoppelde software verwijderen.
3. Documenten opnieuw aanbieden: Postvak IN/UIT > drie puntjes > "API-download opnieuw aanbieden". Bij dubbele-markering eerst "Als origineel markeren".