Fehlermeldungen und Lösungen pro ERP-Paket. Dieser Artikel behandelt paketspezifische Fehler. Für generische API-, Webhook- und Konnektivitätsprobleme: siehe Fehlerbehebung Integrationen.

Fehlermeldungen mit dem Präfix U4 stammen aus Unit4 ERPx. Die Lösung liegt fast immer auf der Softwareseite, nicht bei eConnect. Der Kunde kann die XML-Datei von der Plattform herunterladen und an den Unit4-Administrator weiterleiten.

DueDate-Kompensation: Unit4 kann Rechnungen ohne DueDate/PaymentDueDate nicht verarbeiten (das Feld ist im XML nicht verpflichtend). eConnect setzt das PaymentDueDate standardmäßig auf das IssueDate (Rechnungsdatum) plus 30 Tage, wenn dieses Feld fehlt. Dies ist eine standardmäßige Rule Based Enrichment, pro Kunde als PrivateObject in der PSB konfiguriert (typischerweise mit Id unit4-setDueDate-30days).

Rechnung gebucht, aber PDF-Anhang fehlt: frühere Verbindungsunterbrechungen auf der Unit4-Seite, bei denen das PDF verloren ging, werden inzwischen wiederholt (bestätigt von Platform & Integrationen, Mai 2026). Verbleibende Fälle: siehe den Diagnosepfad unten.

UBW ist der klassische Agresso/UBW-Name; innerhalb eConnect verwenden wir ihn als Suchalias neben Unit4 ERPx, wo diese Weiterleitung stattfindet.

Symptom: eine eingehende Rechnung (oft nicht-Peppol) wurde manuell an @trust.econnect.eu gemailt, ist in der Plattform sichtbar, steht aber (noch) nicht in UBW/Agresso oder dem angeschlossenen Finanzpaket. Siehe auch Email Receiver für den Eingang über diese Adresse.

Treffe zuerst diese Unterscheidung, bevor du eskalierst:

1. Vorübergehende Batch- oder Weiterleitungsverzögerung: das Dokument befindet sich korrekt in der Plattform, aber der automatische Abhol- oder Buchungsprozess des Kunden muss noch laufen oder läuft gerade. Dies löst sich meist selbst; es liegt keine Störung vor.
2. Dauerhaft nicht angekommen: nach dem erwarteten Lauf fehlt die Rechnung weiterhin. Fahre dann fort mit Diagnose: Rechnung nicht in ERPx angekommen ohne Fehlermeldung unten (Integrationstyp, documentId/consignmentId, Events, Idempotenz zwischen Autopilot und ERPx).

Bei einer neuen Meldung:

1. Bestätige die Sichtbarkeit und den Status der Rechnung in der Plattform.
2. Frage nach dem Integrationstyp oder ERP-Paket (UBW/Agresso, Unit4 ERPx über Autopilot, SFTP/PSB, ...) und ob der automatische Prozess heute bereits gelaufen ist.
3. Ist der Prozess noch nicht gelaufen oder läuft er gerade? Warte dann kurz ab und bestätige nach dem Lauf. Eskaliere nicht vorzeitig.
4. Ist der Prozess gelaufen und fehlt die Rechnung dauerhaft? Sammle die IDs und folge dem Diagnosepfad unten.

Es gibt kein festes SLA in Stunden zwischen der Einreichung über den Email Receiver und der Verarbeitung in UBW/ERPx.

Dieser Pfad gilt für Beschwerden wie „In eConnect gebucht, aber in ERPx nicht sichtbar" oder „Rechnung scheint nie angekommen zu sein, keine Meldung im Document Journal".

Hintergrund: Die Autopilot -- Unit4 ERPx-Route ist idempotent (Abgleich auf Rechnungsnummer + Kunde + Lieferant). Bei einem Treffer wird ERPx nicht erneut aufgerufen und nur ein fehlendes PDF hochgeladen, während die Plattform dennoch Booked anzeigt. Ein leeres Document Journal für die zweite Einreichung bedeutet also nicht, dass die Rechnung verloren ist, sondern meist, dass die idempotente Prüfung ausgelöst wurde.

Dies zuerst bei einem Unit4-Partner mit mehreren Rechnungen prüfen:

0. Nur zugestellt, kein Journal: Status Delivered/Empfangen im Posteingang mit 0 Treffern in den Document Journals bedeutet, dass noch kein Autopilot-Buchungsversuch (Booked/Booking failed) stattgefunden hat. Reichen Sie die Rechnung zuerst erneut bei der verbundenen Software ein; starten Sie erst danach eine Events-Untersuchung. Siehe Autopilot -- Dokumentjournale.
1. Parteien trennen: Der empfangende Kunde (ERPx-Benutzer) ist nicht derselbe wie der Lieferant auf der Rechnung und auch nicht derselbe wie eine eventuelle Zwischenpartei auf einem beigefügten Log.
2. Richtiges Log oder Dokument: Prüfen Sie, ob der Anhang oder das eConnect-Log das beanspruchte Dokument ist (Rechnungsnummer, Lieferant zu Empfänger). Ein falsches Log ist ein anderes Dokument; starten Sie darauf keine ERPx-Untersuchung.
3. Kennzeichen pro beanspruchter Rechnung: mindestens die Rechnungsnummer, vorzugsweise auch documentId oder consignmentId. Mehrere fehlende Rechnungsnummern sind separate Dokumente; Booked auf Rechnung A deckt Rechnung B nicht ab.
4. Booked plus Duplikatfehler (z. B. invoice number already exists, oder nach erneuter Einreichung): Oft wurde dieselbe Rechnungsnummer erneut gesendet. Die Plattform kann Booked bei der früheren Buchung anzeigen; das ist kein Beweis, dass eine andere Rechnungsnummer in ERPx steht. Bestätigen Sie dies über Events (Schritt 3 unten) oder eine bestehende ERPx-Registrierung.

Schritte:

Die ABWInvoice-Transformation wurde auf Basis ursprünglicher Testdokumente erstellt. Abweichende Dokumentvarianten (z.B. Freitext-Rechnungen) können mit "API400: Initializing failed" fehlschlagen. Lösung: Änderungsantrag bei der Entwicklung für eine Transformationserweiterung.

Fehlermeldungen mit dem Präfix BC stammen aus Business Central. Wenig Einfluss seitens eConnect; der Kunde muss die BC-Konfiguration prüfen.

Das Präfix in eckigen Klammern gibt die Art der Antwort an, die eConnect von Business Central beim Buchen der Rechnung erhalten hat:

• [BC400] -- eine von Business Central abgelehnte Anfrage (BC gab einen 400-artigen Fehler zurück). Dies ist fast immer ein Validierungs- oder Tabellenbeziehungsfehler in der BC-Konfiguration des Kunden (z.B. ein fehlender Wert in einer verknüpften Tabelle oder ein Feld, das eine BC-Bedingung nicht erfüllt). Der Text direkt nach [BC400]: (wie Internal_InvalidTableRelation oder Application_FieldValidationException) benennt den konkreten BC-Fehler und verweist auf das zu korrigierende Feld oder die Tabelle.
• [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- ähnliche BC-seitige Antworten (abgelehnte Anfrage, nicht gefunden, Ratenbegrenzung).
• [API400] -- von der eConnect API selbst abgelehnt, für BC (z.B. eine falsche Verbindungseinstellung).

In allen BC-Präfix-Fällen liegt die Lösung auf der BC-Seite (Kundenkonfiguration); eConnect hat hier wenig Einfluss.

Bekannte Störung? Prüfen Sie zunächst status.exact.com auf aktuelle Exact-Störungen -- unabhängig von der eigenen eConnect-Statusseite (support.econnect.eu/status/). Eine Störung bei Exact selbst (z. B. Exact Online, Exact API) erklärt manchmal Fehler, die nicht an der eConnect-Kopplung liegen.

Verbindung: SOAP-Enterprise, nur Empfangen (Einkauf). Einrichtung: ECI Inventive verbinden.

Zwei Ursachen, nicht verwechseln:

1. eConnect-Plattformstörung: zum Beispiel PDF-Anhänge, die nicht mitgeliefert werden. Prüfen Sie den Rechnungsstatus im eConnect-Posteingang.
2. Eigener Payload-Validierungsfehler auf der Inventive-Seite: liegt außerhalb des Umfangs des eConnect-Supports. Der Inventive-Administrator untersucht dies.

Status "verarbeitet" im eConnect-Posteingang bedeutet, dass eConnect die Rechnung korrekt zugestellt hat. Fehlt die Rechnung danach noch in Inventive, prüfen Sie zunächst den Inventive-Payload/Import (Batch-Jobs), nicht erneut den eConnect-Empfang.

Bei jedem ERP-Paket gelten die folgenden Schritte:

1. Verbindung testen: alle Pakete benötigen Port 443 zum eConnect-Endpunkt.
2. Software-Integration widerrufen: Plattform > Verbindungen > Schlüssel widerrufen > auch in der verknüpften Software entfernen.
3. Dokumente erneut einreichen: Posteingang/-ausgang > drei Punkte > "API-Download erneut einreichen". Bei Duplikatmarkierung zuerst "Als Original markieren".