eConnect-Dokumentenaustauch-Einstellungen in 4PS Business Central
Verbindung testen in 4PS Business Central
Kundenkarte mit E-Rechnungsdaten in 4PS Business Central
/ docs
ProduktWissenEntwickler
Plattform Control
4PS Business Central

4PS Business Central über API mit Verbindungsschlüsseln und Subscription Key verbinden.

IntegrationsmethodeAPI (API31 + Subscription Key)RichtungSenden + EmpfangenMindestabonnementProfessionalVertrag erforderlichJa (über Vertrieb)

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
  1. Gehen Sie in 4PS Business Central zu den eConnect-Dokumentenaustauch-Einstellungen.
  2. Wählen Sie bei Verbindungstyp die Option API31.
  3. 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
  4. 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:

  • Präfix: soapenv
  • Namensraum: http://schemas.xmlsoap.org/soap/envelope/
Schritt 3: Kundenkarte für den Versand einrichten

Um Ausgangsrechnungen versenden zu können, ist ein Identifikator (Handelsregisternummer, GLN oder USt-IdNr.) auf der Kundenkarte obligatorisch.

  1. Öffnen Sie die Kundenkarte in 4PS Business Central.
  2. 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 Broker) 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 globalen Admin- oder Super-Admin-Rechten muss verfügbar sein
  • Prüfen Sie vorab, ob die eConnect-Erweiterung installiert werden darf (bei manchen Organisationen ist dies nur außerhalb der Bürozeiten erlaubt)
Schritt 1: Erweiterung installieren
  1. Öffnen Sie Business Central und suchen Sie über die Suchleiste nach Erweiterungsverwaltung.
  2. Suchen Sie nach "eConnect" und installieren Sie die Erweiterung über die drei Punkte.
Schritt 2: Erweiterung konfigurieren
  1. Klicken Sie auf den eConnect Peppol-Link und aktivieren Sie HttpClient-Anfragen.
  2. Wählen Sie bei PSB-Umgebung die richtige Umgebung (Akzeptanz zum Testen, Produktion für den Live-Betrieb).
  3. Klicken Sie auf Mit dem eConnect PSB verbinden.
  4. Melden Sie sich mit Ihrem Microsoft Entra ID-Konto an. Dieses Konto muss ausreichende Rechte für die BC API haben.
  5. 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).
  6. 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 eingereicht und validiert (Fehler noch korrigierbar). Bei Manuell ist die Rechnung nach dem Buchen nicht mehr änderbar.XMLPorts(optional)Eigenes Mapping von BC-Feldern zur E-Rechnung-XML.
Schritt 4: Kundenkarte einrichten
  • Sendeprofil auf eConnect setzen.
  • "Elektronische Rechnungsstellung" auf Dokument-Sendeprofil setzen.
  • Endpunkt-ID vollständig einschließlich SchemeID eingeben, z.B. 0106:12345678.
Eingehend über Autopilot

Die Verbindung für eingehende Rechnungen wird über den Autopilot in der eConnect-Plattform hergestellt. Siehe Autopilot: Rechnungen automatisch importieren.

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.

Benötigen Sie Hilfe bei der Verbindung? Kontaktieren Sie den Support.

Ihre Buchhaltung verbinden