Symptom

Nach einem Upgrade auf SAP Business One 10.0 FP 2608 schlägt das Zuordnen eines elektronischen Dateiformats oder das Erzeugen einer Bankdatei, eines elektronischen Belegs oder einer elektronischen Meldung mit einer dieser Fehlermeldungen fehl:

Cannot call the electronic file manager; contact technical support. EFM URI not defined. Check SLD.
Cannot call the Electronic Document Service. Contact technical support. CEDFHttpClient Exception: (7) Could not connect to server.

Typische Stellen, an denen der Fehler auftritt:

  • Bankenabwicklung: beim Zuordnen eines Bankdateiformats (BPP) zu einer Zahlungsart oder wenn der Zahlungsassistent eine Zahlungsdatei mit einem bestehenden Format erzeugt.
  • Administration → Definitionen → Allgemein → Electronic File Manager: beim Zuordnen eines GEP- oder SPP-Formats.
  • Elektronische Belege und Meldungen: beim Ausführen einer GEP-basierten Meldung oder beim Erstellen eines SPP-basierten elektronischen Belegs bzw. einer Meldung.

Beispiel: Auf SP 2605 erstellt der Zahlungsassistent die SEPA-Zahlungsdatei für einen Zahlungslauf wie gewohnt. Nach dem Upgrade auf FP 2608 bricht derselbe Lauf mit demselben Format mit dem Fehler EFM URI not defined ab, und es wird keine Datei erzeugt.

Das Problem fällt anfangs oft nicht auf. Der Upgrade-Assistent läuft ohne Fehler durch, und die tägliche Arbeit im Client ist nicht betroffen. Der Fehler zeigt sich erst beim nächsten Zahlungslauf, Kontoauszugsimport oder bei der nächsten gesetzlichen Meldung, oft Tage später und kurz vor einer Frist.

Betroffen sind alle Funktionen, die elektronische Datei-Mappings verwenden, zum Beispiel:

  • Elektronische Belege wie FPA (Italien), KSeF (Polen), CFDI (Mexiko), NF-e (Brasilien), eInvoice (Frankreich), Veri*factu (Spanien) und PEPPOL
  • Elektronische Meldungen auf Basis von SPP-Mappings, etwa BAS, Digipoort (Niederlande), MTD (Vereinigtes Königreich) sowie MYF und E-Books (Griechenland)
  • Meldungen auf Basis von GEP-Mappings, etwa der Intrastat-Assistent, die Quellensteuermeldung, DIOT (Mexiko) und die Zusammenfassende Meldung (Deutschland)
  • Der Zahlungsassistent (BPP) und der Kontoauszugsassistent (BFP)

Ursache

Ab FP 2608 hat SAP den Electronic File Manager aus dem SAP-Business-One-Client in eine eigene Serverkomponente ausgelagert, den EFM Transformation Service. Der Client und der Electronic Document Service schicken jede Dateitransformation jetzt an diesen Dienst. Ist der Dienst nicht installiert, findet der Client im System Landscape Directory (SLD) keine Dienstadresse. Ist er installiert, aber gestoppt oder nicht erreichbar, schlägt die Verbindung fehl.

Wer betroffen ist

Alle folgenden Bedingungen müssen zutreffen:

  • Das System läuft auf SAP Business One 10.0 FP 2608 oder höher, mit Microsoft SQL Server oder SAP HANA.
  • Sie nutzen mindestens eine Funktion, die elektronische Datei-Mappings verwendet (siehe Liste oben).
  • Der EFM Transformation Service ist nicht installiert, nicht im SLD registriert oder läuft nicht.

In SAP Business One Cloud sind Landschaften auf SAP Business One Cloud 1.1 PL22 oder niedriger immer betroffen, weil sich der Dienst dort nicht installieren lässt.

Der Fehlertext zeigt, wo Sie suchen müssen:

  • EFM URI not defined. Check SLD. bedeutet, dass der Dienst nicht installiert oder nicht im SLD registriert ist.
  • Could not connect to server bedeutet, dass der Dienst installiert ist, aber nicht läuft oder nicht erreichbar ist.

Ob der Dienst installiert ist und läuft, prüfen Sie auf dem Server, auf dem er laufen soll.

Unter Windows (PowerShell):

PowerShell
Get-Service -DisplayName "*EFM Transformation*"

Unter Linux:

Shell
systemctl status sapb1efmt

Liefert der Befehl nichts oder meldet einen unbekannten Dienst, ist er nicht installiert. Der Status Running bzw. active (running) bedeutet, dass er läuft. Ein laufender Dienst beweist aber nicht, dass Client und Electronic Document Service ihn erreichen. Unterschiedliche Hostnamen-Formate im SLD oder eine Firewall können die Verbindung trotzdem blockieren. Prüfen Sie deshalb zusätzlich das SLD Control Center, wie unter Ergebnis prüfen beschrieben.

Problem auf FP 2608 verhindern

Installieren Sie den EFM Transformation Service als Teil des Upgrades, bevor die Anwender auf FP 2608 arbeiten:

  1. Stellen Sie sicher, dass das SLD installiert ist und mindestens ein Datenbankserver mit Hostname oder IP-Adresse registriert ist.
  2. Starten Sie den Component Wizard aus dem Installationspaket von FP 2608 und wählen Sie Electronic File Mapping Transformation Service aus.
  3. Installieren Sie den Dienst auf einem Rechner, der das SLD erreicht und den der Electronic Document Service erreicht. Verwenden Sie dasselbe Format für Hostname oder Adresse wie bei der Registrierung des Datenbankservers im SLD.
  4. Starten Sie den Dienst neu. Unter Windows über die Dienste-Verwaltung (SAP Business One EFM Transformation Service), unter Linux mit:
Shell
systemctl restart sapb1efmt

Beachten Sie:

  • Der Dienst ist passiv: Er wartet auf Anfragen vom Client, vom Electronic Document Service und vom Job Service. Der Electronic Document Service hängt von ihm ab.
  • Belege und Zahlungen buchen Sie im Client auch ohne den Dienst. Nur Schritte, die eine elektronische Datei erzeugen oder einlesen, schlagen fehl.
  • Die Konfigurationsdateien appsettings.json und log4net.conf liegen unter Windows in C:\Program Files\SAP\SAP Business One EFM Transformation Service\conf\` und unter Linux in `/usr/sap/SAPBusinessOne/EFMTransformationService/conf/. Dort stellen Sie die Protokollstufe ein und begrenzen parallele Verbindungen (Kestrel → Limits → MaxConcurrentConnections). Starten Sie den Dienst nach jeder Änderung neu.
  • Es gibt keine Einstellung, die das bisherige integrierte Verhalten zurückbringt. SAP beschreibt den Dienst ab FP 2608 als erforderlich.

On-premises läuft der Dienst unter Windows oder Linux. Für die Version für SAP HANA unter Linux verwalten Sie ihn wie oben gezeigt mit systemctl.

In SAP Business One Cloud setzt der Dienst SAP Business One Cloud 1.1 PL23 oder höher voraus. Bei niedrigeren Versionen blockiert der Component Wizard die Installation mit dieser Warnung:

The Electronic File Mapping Transformation Service is compatible with SAP Business One Cloud PL23 and higher. Lower versions are not supported.

Aktualisieren Sie zuerst die Cloud-Landschaft auf PL23 oder höher und installieren Sie danach den Dienst.

Den vollständigen Upgrade-Pfad und die weiteren Voraussetzungen für FP 2608 finden Sie in SAP Business One 10.0 FP 2608: Upgrade-Pfade und Voraussetzungen.

Ergebnis prüfen

  • Öffnen Sie im SLD Control Center die Registerkarte Services. Prüfen Sie, ob der EFM Transformation Service aufgeführt ist und sich sein Dashboard über den Link in der Spalte Link öffnet.
  • Ordnen Sie einer Zahlungsart erneut ein Bankdateiformat zu und erzeugen Sie eine Test-Zahlungsdatei. Vergleichen Sie sie mit einer Datei von vor dem Upgrade, bevor Sie etwas an die Bank senden.
  • Führen Sie in Ihrer Testfirma eine GEP-basierte Meldung aus und erstellen Sie einen elektronischen Beleg.
  • Prüfen Sie elektronische Belege und Meldungen, die erstellt wurden, während der Dienst fehlte. Sie können einen Fehlerstatus haben und müssen erneut gesendet werden.
  • Prüfen Sie geplante Jobs, die Berichte oder Dateien erzeugen, da sie im Hintergrund fehlgeschlagen sein können.