Verbinden Sie 4PS Business Central im Jahr 2026 mit eConnect über eine API-Verbindung. Dies erfordert einen Vertrag mit API-Rechten und einen Subscription Key, den Sie vom Vertrieb von eConnect erhalten.
Bevor Sie beginnen
Ein aktives eConnect-Konto mit mindestens einem Professional-Abonnement
Ein Vertrag mit eConnect für API-Rechte, einschließlich Subscription Key
Eine aktivierte Organisation auf der eConnect-Plattform
Administratorzugang zu Ihrer 4PS Business Central-Umgebung
Verbindung einrichten
Schritt 1: Verbindungsschlüssel erstellen
Erstellen Sie Verbindungsschlüssel in der eConnect-Plattform. Folgen Sie den Schritten unter Verbindungsschlüssel erstellen.
Schritt 2: Einrichtung in 4PS Business Central
Gehen Sie in 4PS Business Central zu den eConnect-Dokumentenaustauch-Einstellungen.
Wählen Sie bei Verbindungstyp die Option API31.
Geben Sie folgende Daten ein:
Die Verbindungsschlüssel (App Key und Secret)
Die eConnect-Unternehmens-ID (unter Organisationen auf der Plattform, beginnt mit "XC...")
Den Subscription Key, den Sie vom Vertrieb erhalten haben
Klicken Sie auf Verbindung testen, um zu prüfen, ob alles korrekt eingerichtet ist.
Wenn der Test fehlschlägt
Überprüfen Sie, ob die "Generischen Webservice-Namensräume" korrekt ausgefüllt sind:
Um Ausgangsrechnungen versenden zu können, ist ein Identifikator (Handelsregisternummer, GLN oder USt-IdNr.) auf der Kundenkarte obligatorisch.
Öffnen Sie die Kundenkarte in 4PS Business Central.
Richten Sie die E-Rechnungsdaten im Abschnitt Verkauf ein.
Verbindung über den PSB (neuer Integrationspfad)
Neben der oben beschriebenen API31-Verbindung steht ein neuerer Integrationspfad über den eConnect PSB (Peppol Service Bus) zur Verfügung. Dieser Pfad verwendet die eConnect-Erweiterung in Business Central und Microsoft Entra ID für die Authentifizierung. Der Legacy-Pfad (API31 + Subscription Key) bleibt vollständig unterstützt.
Vorbereitung
Bevor Sie beginnen, benötigen Sie Folgendes:
Den Benutzernamen der Person, die die Verbindung herstellt
Organisationsnamen und Handelsregisternummer (oder andere Unternehmensnummer)
Jemand mit Global-Admin- oder Super-Admin-Rechten muss für die einmalige AppSource-Installation und die erste Admin-Zustimmung in Microsoft Entra ID verfügbar sein
Eine vollwertige Business-Central-Benutzerlizenz (Essentials oder Premium) für die Person, die die Verbindung einrichtet. Eine reine API-Lizenz reicht nicht
Prüfen Sie vorab, ob die eConnect-Erweiterung installiert werden darf (bei manchen Organisationen ist dies nur außerhalb der Bürozeiten erlaubt)
Hinweis: Global Admin ist nur für die einmalige Installation der Erweiterung und die erste Entra-ID-Zustimmung erforderlich. Für das tägliche Einrichten der Verbindung reicht ein BC-Benutzer mit Essentials oder Premium.
Es ist hilfreich, den Kunden die Einstellungen vorab bis zum Bildschirm durchlaufen zu lassen, auf dem noch keine partyIds verknüpft sind. Manchmal muss ein Entra-ID-Administrator zuerst die Zustimmung erteilen, um sich bei eConnect anzumelden. Das kann vorab geregelt werden.
Schritt 1: Erweiterung installieren
Öffnen Sie Business Central und suchen Sie über die Suchleiste nach Erweiterungsverwaltung.
Suchen Sie nach "eConnect" und installieren Sie die Erweiterung über die drei Punkte.
Schritt 2: Erweiterung konfigurieren
Klicken Sie auf den eConnect Peppol-Link und aktivieren Sie HttpClient-Anfragen.
Wählen Sie bei PSB-Umgebung die richtige Umgebung (Akzeptanz zum Testen, Produktion für den Live-Betrieb).
Klicken Sie auf Mit dem eConnect PSB verbinden.
Melden Sie sich mit Ihrem Microsoft Entra ID-Konto an. Dieses Konto muss ausreichende Rechte für die BC API haben.
Beim ersten Mal erscheint ein Bildschirm, der anzeigt, dass die partyIDs noch nicht verknüpft sind. Wenden Sie sich in diesem Fall an TechSupport, der die partyIDs verknüpft. Melden Sie sich danach erneut an (vorzugsweise in einem Inkognito-Fenster).
Wählen Sie den Organisationsnamen und überprüfen Sie die Einstellungen. Versand über Peppol muss aktiviert sein.
Schritt 3: Sendeprofil konfigurieren
Nach der Einrichtung der Erweiterung müssen Sie das Sendeprofil konfigurieren.
EinstellungOptionenErläuterungStandardJa / NeinDas Standardprofil wird verwendet, wenn auf der Kundenkarte kein Sendeprofil eingestellt ist. Meist nicht als Standard einstellen, da dies Probleme bei Kunden ohne Peppol-Unterstützung verursacht.VerarbeitungsmodusManuell / AutomatischBei Automatisch wird die Rechnung beim Buchen direkt angeboten und vor dem Buchen validiert (Fehler sind noch änderbar). Bei Manuell ist die Rechnung nach dem Buchen nicht mehr änderbar. Bei Fehlern brauchen Sie eine Korrekturrechnung.XMLPorts(optional)Eigenes Mapping von BC-Feldern auf E-Rechnungs-XML. Standardmäßig ist das eConnect-Mapping eingestellt.
Schritt 4: Kundenkarte einrichten
Auf der Kundenkarte richten Sie die E-Rechnung pro Kunde ein:
Setzen Sie das Sendeprofil auf eConnect. Bei 4PS ist dieses Feld manchmal ausgeblendet. Suchen Sie es über "Personalisieren".
Setzen Sie "elektronische Rechnungsstellung" auf Sendeprofil von Dokumenten (nicht "eVerbinding", das gehört zur alten Verbindung).
Füllen Sie die Endpunkt-ID vollständig einschließlich schemeID aus, zum Beispiel 0106:12345678.
Wenn auf der Rechnung eine andere ID stehen muss (zum Beispiel eine GLN oder eine USt-IdNr.): tragen Sie bei Legal ID einen Identifikator mit einer schemeID ein, die nicht mit 9 beginnt.
Stellen Sie sicher, dass die Felder "Ihre Referenz" oder "externe Belegnummer" ausgefüllt sind. Diese werden als BuyerReference oder Bestellnummer verwendet.
Eingehend über Autopilot
Die Verbindung für eingehende Rechnungen wird über den Autopilot in der eConnect-Plattform hergestellt. Dafür brauchen Sie einen Plattformbenutzer mit Zugang zu allen Organisationen und einen Benutzer mit Admin-Rechten in Business Central. Siehe Autopilot: Rechnungen automatisch importieren für die Schritte.
Häufig gestellte Fragen
Was ist der Unterschied zwischen der API31-Verbindung und der PSB-Verbindung?
Die API31-Verbindung verwendet Verbindungsschlüssel und einen Subscription Key und ist der ursprüngliche Integrationspfad. Die PSB-Verbindung ist neuer, verwendet die eConnect-Erweiterung in Business Central und Microsoft Entra ID. Beide Pfade werden vollständig unterstützt.
Wie empfange ich Eingangsrechnungen in 4PS Business Central?
Eingehende Rechnungen werden über den Autopilot in der eConnect-Plattform verbunden. Sie benötigen einen Plattformbenutzer mit Zugang zu allen Organisationen und einen Benutzer mit Admin-Rechten in Business Central.
Was tun, wenn der Verbindungstest in 4PS Business Central fehlschlägt?
Prüfen Sie, ob die generischen Webservice-Namensräume korrekt ausgefüllt sind (Präfix: soapenv, Namensraum: http://schemas.xmlsoap.org/soap/envelope/). Überprüfen Sie auch, ob Verbindungsschlüssel, Unternehmens-ID und Subscription Key korrekt eingegeben wurden.