Unit4 mit eConnect verbinden: ERPx über den Autopilot, ERP CR über SFTP und Financials über HTTPS.
Unit4 bietet 2026 drei Varianten mit jeweils eigener Integrationsmethode. Welche für Sie gilt, hängt von Ihrem Unit4-Produkt ab.
Unit4 ERPx verbinden Sie über den Autopilot. Eingangsrechnungen werden automatisch eingelesen und verbucht. Die Konfiguration wird während der Implementierung mit eConnect eingerichtet.
Die Autopilot-Konfiguration erfolgt über einen Schritt-für-Schritt-Assistenten in der eConnect-Plattform:
Achtung: Verarbeiten Sie zuerst alle Dokumente über die bisherige Route, bevor Sie umstellen. Die Konfiguration der Verbindung wird nicht vom Kunden selbst durchgeführt, sondern während der Implementierung.
Beim Verbuchen über Unit4 ERPx kann die Meldung [U4OK.JSON]: System.Int32 overflow auftreten. Ursache: Die Rechnungsnummer ist numerisch so groß, dass sie außerhalb des Limits einer 32-Bit-Ganzzahl liegt (maximal 2.147.483.647). In diesem Teil der Unit4-Verarbeitung kann das System die Nummer dann nicht verarbeiten. Das ist eine Einschränkung in Unit4 selbst, nicht in der eConnect-Verbindung oder in unserem Integrationscode.
In der Praxis sehen Sie dies bei Organisationen, die sehr hohe Nummernkreise für ausgehende Rechnungsnummern verwenden (zum Beispiel Werte deutlich über 2 Milliarden).
Was können Sie tun? Die Lösung muss von Unit4 kommen. Das Ändern der Rechnungsnummer in der Quell-XML über eConnect ist ohne Risiko für Ihre Verwaltung und Nummerierung keine praktikable Workaround. Unit4 ist informiert und arbeitet an einer strukturellen Behebung. Bis dahin: Eskalieren Sie an Ihren Unit4-Administrator oder Partner und nutzen Sie bei Bedarf den XML-Download aus der eConnect-Plattform (Posteingang), um den Fall zu untermauern.
Unit4 ERP CR (einschließlich ERP7) und Unit4 Financials by Coda verbinden Sie über SFTP bzw. HTTPS. Diese Enterprise-Integrationen erfordern einen Vertrag und werden von Unit4 oder einem Unit4-Partner in Zusammenarbeit mit eConnect konfiguriert.
Die Standard-Integrationsmethode für Unit4 ERP CR und ERP7 ist SFTP (Secure File Transfer Protocol). Mehr Informationen dazu, wie eine SFTP-Integration technisch eingerichtet wird, finden Sie im Artikel SFTP-Integration.
In der Vergangenheit konnte es vorkommen, dass eine Rechnung erfolgreich in Unit4 ERPx verbucht wurde, der PDF-Anhang aber nicht mitgeliefert wurde. Die Ursache lag in einer Verbindungsunterbrechung auf Unit4-Seite, bei der die PDF verworfen wurde. Seit Mai 2026 werden diese Fälle automatisch erneut versucht, bestätigt durch Platform & Integraties. In den meisten Situationen sollten Sie dieses Problem also nicht mehr sehen.
Treffen Sie dennoch noch einen Fall an, in dem eine Rechnung verbucht ist, der PDF-Anhang aber fehlt, handelt es sich um einen Restfall. Folgen Sie dann dem Diagnosepfad unten, um festzustellen, ob das Dokument wirklich verloren gegangen ist oder ob eine idempotente Übereinstimmung vorliegt.
Tipp: Die Rechnung selbst können Sie jederzeit aus der eConnect-Plattform herunterladen (Posteingang, drei Punkte beim Dokument). Leiten Sie das Dokument bei Bedarf manuell an Ihren Unit4-Administrator weiter.
Unit4 ERPx kann Eingangsrechnungen ohne Fälligkeitsdatum (DueDate/PaymentDueDate) nicht verarbeiten; das Feld ist im XML nicht verpflichtend. Kommt eine Rechnung ohne dieses Feld an, setzt eConnect das PaymentDueDate standardmäßig auf das IssueDate (Rechnungsdatum) plus 30 Tage. Damit verhindern wir, dass die Buchung an einem formal fehlenden Feld scheitert, während die inhaltliche Zahlungsfrist in der Praxis meist 30 Tage beträgt.
Dies ist eine standardmäßige Rule Based Enrichment (RBE), pro Kunde als PrivateObject in der PSB konfiguriert (typischerweise mit Id unit4-setDueDate-30days). Möchten Sie eine andere Standardfrist verwenden, wenden Sie sich an den Support; das ist keine Self-Service-Einstellung.
Dieser Diagnosepfad gilt für Meldungen wie „die Rechnung steht auf Booked in eConnect, aber ich sehe sie nicht in ERPx“ oder „die Rechnung scheint nie angekommen zu sein, das Document Journal zeigt nichts“. Hintergrund: Die Autopilot ↔ Unit4 ERPx-Route ist idempotent (Abgleich über Rechnungsnummer plus Kunde plus Lieferant). Bei einer Übereinstimmung ruft eConnect ERPx nicht erneut auf und lädt nur eine fehlende PDF hoch, während die Plattform dennoch Booked anzeigt. Ein leeres Document Journal für die zweite Einreichung bedeutet also meist nicht, dass die Rechnung verloren ist, sondern dass die idempotente Prüfung ausgelöst wurde. Siehe auch Autopilot — idempotente Buchung.
Die Interpretation der Statuslabels unterscheidet sich je nach Verbindungstyp. Stellen Sie fest, ob es sich um Autopilot (Unit4 ERPx), eine andere PSB-Route, eine direkte SOAP API oder eine SFTP-Verbindung handelt. Siehe die Statustabelle in Autopilot — Buchungsstatus für die Bedeutung je Verbindungstyp.
Notieren Sie mindestens eine dieser beiden IDs für das Dokument:
documentId (von der PSB), oderconsignmentId (von der Plattform).Eine der beiden reicht aus, um das Dokument in allen internen Systemen zu finden.
Öffnen Sie das Dokument in der internen Management API über documentId oder consignmentId und prüfen Sie die Events-Zeitachse. Darin steht pro Schritt, welche Aktion am Dokument ausgeführt wurde: Empfang, Validierung, Einreichung an ERPx, Retries, idempotente Übereinstimmung und PDF-Upload. Bei SFTP-Verbindungen ist dies die einzige Stelle, an der der Delivery-Status sichtbar ist, da das Softwarepaket über SFTP keine Statusrückmeldung liefert.
Sehen Sie in der Events-Zeitachse, dass eConnect die Rechnung als vorhanden erkannt hat (gleiche Rechnungsnummer, Kunde und Lieferant) und nur einen PDF-Upload ausgeführt hat? Dann ist dies erwartetes Verhalten. Die Rechnung stand bereits in ERPx von einer früheren Einreichung. Kommunizieren Sie dies an den Kunden zurück; eine Eskalation ist nicht erforderlich.
Nur wenn die Events-Zeitachse kein schlüssiges Bild liefert, eskalieren Sie an das technische Team. Geben Sie dabei mindestens an:
documentId oder consignmentId,partyId,Bei der Verarbeitung von Rechnungen über die ABWInvoice-Transformation (verwendet bei Agresso/Unit4-Integrationen) kann die Fehlermeldung [API400]: Initializing failed. Unhandled error occurred. auftreten. Die Ursache ist, dass die Transformation auf Basis der ursprünglichen Testdokumente erstellt wurde. Abweichende Dokumentvarianten (zum Beispiel Free-Text-Rechnungen) enthalten Felder, die in der Mapping fehlen, wodurch die Transformation fehlschlägt.
Es läuft ein Änderungsantrag, die Transformation für mehrere Dokumenttypen zu erweitern. Wenn Sie diese Fehlermeldung sehen, wenden Sie sich an den Support.
Bei Unit4-Integrationen mit Fremdwährung (z. B. USD mit Kurs) liegt die Währungskonfiguration in der Verantwortung des Kunden in der Unit4-Umgebung. eConnect verarbeitet, was das ERP liefert. Supportanfragen zu Fremdwährung verweisen auf die ERP-Konfiguration des Kunden.
Fehlermeldungen, die mit dem Präfix U4 beginnen, stammen aus Unit4 ERPx. Die Lösung ist fast immer auf Unit4-Seite zu finden. Sie können die XML-Datei selbst von der eConnect-Plattform herunterladen (Posteingang, drei Punkte beim Dokument) und an Ihren Unit4-Administrator weiterleiten.
MwSt.-Mapping: Unterschied Eingang und Ausgang
Bei Eingangsrechnungen (Autopilot) übernimmt eConnect das MwSt.-Mapping. Sie konfigurieren das Schema über Plattform > Autopilot > Verbindung > Buchungsschema > SCHEMAS VERWALTEN > MwSt. Bei Ausgangsrechnungen führt eConnect kein MwSt.-Mapping durch: Unit4 muss selbst die korrekten UNCL5305-Codes in der Rechnungs-XML mitliefern.
Dies ist eine generische Fehlermeldung mit mehreren möglichen Ursachen: ein Timeout bei Unit4, eine Rechnung mit mehr als 200 Positionen, Rechnungspositionen mit einem Betrag von € 0 oder doppelte MwSt.-Codes im Buchungsschema. Reichen Sie die Rechnung erneut über den Posteingang ein. Tritt der Fehler weiterhin auf, buchen Sie die Rechnung manuell in ERPx und prüfen Sie das MwSt.-Schema auf Duplikate.
Die Kombination aus Lieferant und Rechnungsnummer existiert bereits in Unit4. Prüfen Sie, ob die Rechnung zuvor eingereicht wurde (zum Beispiel über eine andere Route) und ob die IDR die Rechnungsnummer korrekt erkannt hat. Ist die Rechnung tatsächlich doppelt, müssen Sie nichts tun. Handelt es sich um ein anderes Dokument mit derselben Nummer, prüfen Sie die Erkennung in der eConnect-Plattform.
Die Rechnungs-XML enthält einen MwSt.-Code, der im Autopilot-Buchungsschema nicht vorkommt. Das passiert vor allem bei Rechnungen, die per E-Mail eingehen und einen abweichenden oder fehlerhaften MwSt.-Code haben. Fügen Sie die fehlende Zuordnung über Plattform > Autopilot > Verbindung > Buchungsschema > SCHEMAS VERWALTEN > MwSt. hinzu, oder bitten Sie den Lieferanten, die Rechnung über Peppol zu senden (wodurch Standard-MwSt.-Codes verwendet werden).
Der Kreditor in Unit4 ERPx hat keine Zahlungsbedingung (BET.VOORW) hinterlegt. eConnect liefert selbst kein Fälligkeitsdatum an Unit4. Stellen Sie die Zahlungsbedingung auf der Lieferantenkarte in Unit4 ERPx ein.
Der Dummy-Kreditor in Unit4 ist nicht aktiv. Aktivieren Sie den Dummy-Kreditor in Unit4 ERPx und reichen Sie die Rechnungen erneut ein.
Der Rechnungsgesamtbetrag beträgt € 0,00. Eine Rechnung ohne Betrag kann in Unit4 nicht verbucht werden.
Die Buchungsperiode (Buchungszyklus) in Unit4 ERPx ist nicht korrekt eingerichtet oder für den betreffenden Zeitraum nicht aktiv. Prüfen und aktivieren Sie die richtige Buchungsperiode in Unit4.
Das Zahlungskennzeichen auf der Rechnung ist länger als 27 Stellen, was Unit4 nicht akzeptiert. Als vorübergehende Lösung können Sie die Rechnung als PDF statt über die automatische Verbindung einreichen. Strukturell muss der Lieferant das Zahlungskennzeichen kürzen.
Der Machine-to-Machine-Benutzer (M2M), mit dem eConnect sich bei Unit4 anmeldet, hat unzureichende Rechte oder ist deaktiviert. Lassen Sie den Unit4-Administrator die Rechte des M2M-eConnect-Benutzers prüfen und wiederherstellen.
Die Rechnung wurde auf den Dummy-Kreditor verbucht, aber ein früheres Dokument mit derselben Rechnungsnummer steht dort bereits. Verarbeiten Sie zuerst die bestehende Rechnung auf dem Dummy-Kreditor und reichen Sie die neue Rechnung anschließend erneut ein.
Der Routing-Konfiguration in Unit4 ERPx fehlt ein Knoten für den angegebenen Workflow. Das ist ein Problem auf Unit4-Seite. Laden Sie die XML aus der eConnect-Plattform herunter und leiten Sie sie an Ihren Unit4-Administrator weiter, um das Routing anzupassen.
Der angehängten PDF liegt ein ungültiges „data“-Präfix in den Base64-Daten zugrunde (zum Beispiel dataJVBERi0x... statt JVBERi0x...). Bei Rechnungen, die über die IDR eingehen, wird dies automatisch korrigiert. Bei Rechnungen, die direkt über Peppol eingehen, kann dieses Problem noch auftreten. Der Quellabsender muss die XML korrigieren.
Unit4 ERPx verbinden Sie über den Autopilot für den automatischen Empfang von Eingangsrechnungen. Unit4 ERP CR und ERP7 nutzen SFTP, und Unit4 Financials by Coda verbindet über HTTPS. Beide letzten Varianten erfordern einen Vertrag und werden von Unit4 oder einem Unit4-Partner konfiguriert.
Bei Unit4 ERPx wird die Konfiguration während der Implementierung mit eConnect eingerichtet, nicht vom Kunden selbst. Bei Unit4 ERP CR und Financials by Coda führt Unit4 oder ein Unit4-Partner die Konfiguration in Zusammenarbeit mit eConnect durch.
::e-accordion-item{value="item-3" header="Was soll ich bei der Fehlermeldung "Int32 overflow" bei großen Rechnungsnummern tun?"} Dies ist eine Einschränkung in Unit4 selbst, wenn die Rechnungsnummer größer als 2.147.483.647 ist. Die Lösung muss von Unit4 kommen. Eskalieren Sie an Ihren Unit4-Administrator oder Partner und nutzen Sie bei Bedarf den XML-Download aus der eConnect-Plattform, um den Fall zu untermauern. ::
Möchten Sie Unit4 verbinden? Wenden Sie sich an Unit4 oder Ihren Unit4-Partner, oder an eConnect Sales für ein Erstgespräch.
Verbindung starten