Erweiterungsverwaltung in Business Central öffnen
eConnect-Erweiterung aus AppSource installieren
Webdienste in Business Central anlegen
Unterstützte Einrichtung für eConnect starten
Umgebung auswählen und mit eConnect verbinden
Autopilot für Dynamics 365 Business Central konfigurieren
Rechnung manuell über eConnect in Business Central senden
Sendeprofil auf ECONNECT setzen
Kundenkarte mit E-Invoice ID für Peppol-Versand
Aktivitätsprotokoll für eine gesendete Rechnung anzeigen
/ docs
ProduktWissenEntwickler
Plattform Control
Dynamics 365 BC

D365 BC über den Autopilot und die AppSource-Erweiterung für automatische Rechnungsverarbeitung verbinden.

IntegrationsmethodeAutopilot + AppSource-ErweiterungRichtungSenden + EmpfangenMindestabonnementBasicVertrag erforderlichNein

Verbinden Sie Dynamics 365 Business Central (D365 BC) mit eConnect über den Autopilot und die offizielle AppSource-Erweiterung „eConnect Peppol e-invoicing & OCR+". Rechnungen werden automatisch gesendet und empfangen, einschließlich Buchungsvorschlägen für Eingangsrechnungen.

Voraussetzungen
  • Ein aktives eConnect-Konto mit mindestens einem Basic-Abonnement
  • Globale Administratorrechte in Business Central
  • Ausreichendes Transaktionsguthaben auf Ihrem eConnect-Konto
Integration einrichten
Schritt 1: Erweiterung installieren
  1. Suchen Sie in Business Central nach Erweiterungsverwaltung.
  2. Suchen Sie nach eConnect und wählen Sie eConnect Peppol e-invoicing & OCR+.

  1. Klicken Sie auf Installieren und akzeptieren Sie die Nutzungsbedingungen.
  2. Wählen Sie eine Sprache und klicken Sie auf Install.

Schritt 2: Webdienste anlegen
  1. Suchen Sie in Business Central nach Webdienste (Suchleiste oben rechts).
  2. Klicken Sie auf Neu, um die erforderlichen Webdienste gemäß der eConnect-Dokumentation anzulegen.
  3. Aktivieren Sie das Kontrollkästchen Veröffentlicht.

Schritt 3: Unterstützte Einrichtung
  1. Suchen Sie nach Unterstützte Einrichtung und wählen Sie eConnect.
  2. Stellen Sie sicher, dass der Benutzer globale Administratorrechte hat.

  1. Wählen Sie die Umgebung und klicken Sie auf Connect.
  2. Melden Sie sich mit einem Benutzer mit BC Office 365-Administratorrechten an.

  1. Stellen Sie sicher, dass der Benutzer Berechtigungen für die gewünschte partyId hat.
  2. Folgen Sie den Anweisungen auf dem Bildschirm.
Schritt 4: Autopilot konfigurieren (für Eingangsrechnungen)

Wenn Sie Eingangsrechnungen automatisch buchen möchten, konfigurieren Sie den Autopilot in der eConnect-Plattform:

  1. Gehen Sie in der eConnect-Plattform zur Autopilot-App.
  2. Wählen Sie die Organisation und dann Microsoft Dynamics 365 Business Central.
  3. Melden Sie sich mit Ihrem Microsoft-Konto an und wählen Sie Umgebung und Organisation.
  4. Konfigurieren Sie die Autopilot-Einstellungen nach Ihren Wünschen.

Rechnungen senden

Es gibt zwei Optionen für das Senden von Ausgangsrechnungen:

Option 1: Manuell senden
  1. Gehen Sie zu Gebuchte Verkaufsrechnungen und wählen Sie eine Rechnung.
  2. Klicken Sie auf Drucken/Senden > Senden.
  3. Aktivieren Sie eConnect bei der Peppol-Option und klicken Sie auf OK.

Option 2: Nach dem Buchen automatisch senden
  1. Suchen Sie nach Dokumentsendeprofilen.
  2. Stellen Sie sicher, dass das ECONNECT-Profil bei Verarbeitungsmodus auf Automatic gesetzt ist.
  3. Öffnen Sie die Kundenkarte und setzen Sie das Dokumentsendeprofile auf ECONNECT.
  4. Tragen Sie die E-Invoice ID ein (Handelsregisternummer oder OIN-Nummer).
  5. Beim Buchen wird die Rechnung automatisch eingereicht.

Rechnungen empfangen

Über eConnect eingegangene Eingangsrechnungen werden automatisch über den Digitalen Briefkasten oder den Autopilot in Ihrer Business Central-Buchhaltung abgelegt.

Tipp: Das Aktivitätsprotokoll einer Rechnung gibt detaillierte Informationen zur Kommunikation mit der PSB. Gehen Sie zu Gebuchte Verkaufsrechnungen > Rechnungen > Aktivitätsprotokoll.

Lieferantensuche beim Empfang

Wenn eine Eingangsrechnung über eConnect in Business Central eingeht, wird der Lieferant automatisch anhand der Kennungen in der Rechnung gesucht. Die Suchreihenfolge lautet:

PrioritätKennungBC-Feld1Umsatzsteuer-IDVAT_Registration_No2HandelsregisternummerRegistration_Number3IBANBankkonten → No

Die Erweiterung sucht zunächst nach der Umsatzsteuer-ID. Wird keine Übereinstimmung gefunden, folgt die Handelsregisternummer, dann die IBAN. Liefert keine Kennung eine Übereinstimmung, wird die Rechnung nicht gebucht.

Hinweis: Wenn der Lieferant in Business Central nicht existiert, wird er nicht automatisch angelegt. Die Rechnung schlägt dann mit einer Fehlermeldung fehl. Legen Sie den Lieferanten zunächst manuell in Business Central an.

Wird ein Lieferant gefunden, prüft die Erweiterung auch, ob die mitgelieferten Bankkonten (einschließlich etwaiger G-Konten) bei den mit diesem Lieferanten verknüpften Bankkonten vorhanden sind.

Erweiterte Konfiguration
Entra ID-Authentifizierung

Bei der Einrichtung der BC-Erweiterung werden Sie auf die Autopilot Connect-Webseite weitergeleitet, wo die Anmeldung mit einem Microsoft Entra ID-Konto erforderlich ist. Dieses Konto wird auch verwendet, um die BC-Umgebung über die API aufzurufen, und benötigt daher ausreichende Rechte und eine BC-Lizenz.

Nach der Anmeldung wird automatisch ein Benutzer im eConnect-Identity-Server mit dem Anmeldetyp „Business Central Azure Active Directory" angelegt. TechSupport weist dann die tenantId und die partyIds manuell zu. Einem Benutzer können mehrere partyIds zugewiesen werden. Der Kunde wählt dann bei der Einrichtung, welche partyId mit welcher BC-Umgebung verknüpft wird.

Mehrere BC-Umgebungen verbinden

Es ist möglich, mehrere Business Central-Umgebungen zu verbinden, aber dabei gelten einige wichtige Regeln. Jede Umgebung benötigt eine eindeutige partyId. Wenn mehrere Umgebungen Rechnungen im Namen derselben Handelsregisternummer senden müssen, muss jede Verbindung mit einem anderen Entra ID-Konto hergestellt werden. Jeder „Business Central Azure Active Directory"-Benutzer im Identity-Server muss dann auch eine andere tenantId haben.

Es gibt zwei Fallstricke zu beachten:

  • Wenn Sie dieselbe partyId und dasselbe Entra ID-Konto verwenden, überschreibt die neue Verbindung die bestehende. Sie verlieren dann die frühere Integration.
  • Wenn Sie dieselbe partyId mit mehreren Entra ID-Konten im selben Mandanten verwenden, geht der InvoiceSent-Hook nur an eine der BC-Umgebungen.
Client Credentials / App-Registrierung

Als Alternative zur Entra ID-Authentifizierung können Sie sich auch über Client Credentials einer App-Registrierung authentifizieren. Dies eignet sich besonders für die Buchung von Eingangsrechnungen. Für diesen Ablauf gibt es derzeit keine Benutzeroberfläche; TechSupport richtet dies über die API ein.

Die Schritte sind wie folgt:

  1. Erstellen Sie eine neue Verbindung über die Autopilot-Benutzeroberfläche in der Plattform.
  2. Wenn die BC-Umgebung nicht die Standard-Microsoft-Cloud-URL verwendet: Lassen Sie TechSupport die baseUrl über die Management API (Update Attributes) anpassen. Gegebenenfalls müssen auch additionalQueryParameters gesetzt werden.
  3. TechSupport ruft den Aktivierungsendpunkt mit den Client Credential-Daten und BC-Umgebungsinformationen auf. Der referenceKey-Parameter ist ein Base64-kodierter String im Format businesscentral_{contextId}_{tenantId}_{connectionId}.

Wenden Sie sich an den Support, wenn Sie diese Authentifizierungsmethode verwenden möchten.

Häufige Fehlermeldungen

::e-accordion-item{value="item-1" header=""API400 Could not retrieve vendor ids""} Der Lieferant wurde in Business Central anhand der Kennungen in der Rechnung (Umsatzsteuer-ID, Handelsregisternummer oder IBAN) nicht gefunden. Prüfen Sie, ob der Lieferant korrekt angelegt ist und ob die Umsatzsteuer-ID, Handelsregisternummer oder IBAN mit den Angaben in der Rechnung übereinstimmt. ::

::e-accordion-item{value="item-2" header=""BCNotFound: Internal_InvalidTableRelation ... G-Account Code""} Die Rechnung enthält eine G-Kontonummer, die nicht als Bankkonto beim betreffenden Lieferanten hinterlegt ist. Dies kommt bei Organisationen vor, die die Idyn-Erweiterung für G-Konten verwenden. Hinterlegen Sie die G-Kontonummer als Bankkonto beim Lieferanten in Business Central. ::

::e-accordion-item{value="item-3" header=""BCBadRequest: ... Transaction Type ... ECONNECT""} Der Wert „ECONNECT" existiert nicht in der Tabelle Transaction Type. Bei der Installation der eConnect-Erweiterung wird dieser Transaktionstyp normalerweise automatisch angelegt. Bei älteren Versionen müssen Sie ihn manuell hinzufügen: Suchen Sie nach Transaction Types in Business Central und fügen Sie den Code „ECONNECT" hinzu. ::

::e-accordion-item{value="item-4" header=""BCBadRequest: ... VAT Prod. Posting Group""} Die MwSt.-Produktbuchungsgruppe aus der Rechnung existiert nicht in Business Central. Prüfen Sie, ob die MwSt.-Zuordnung korrekt konfiguriert ist. Fügen Sie die fehlende Gruppe zur Tabelle MwSt.-Produktbuchungsgruppe hinzu. ::

::e-accordion-item{value="item-5" header="Autopilot-Verbindung zeigt „Seite funktioniert derzeit nicht""} Wahrscheinlich fehlt dem Benutzer, der die Verbindung herzustellen versucht, eine BC-Lizenz. Verweisen Sie den Kunden an seinen BC-Partner, um die Lizenzzuweisung zu überprüfen. ::

BCTooManyRequests: API-Ratenlimit erreicht

Dieser Fehler kommt von Microsoft Business Central, nicht von eConnect. Das Dokument wurde in der Regel bereits verarbeitet. Prüfen Sie in Business Central, ob die Rechnung gebucht wurde. Wenden Sie sich bei wiederholten Problemen an Ihren BC-Partner, um die API-Limits zu erhöhen.

BCNotFound: PSBWebhookReceiver_ReceiveHook

Die Integration ist beschädigt, meist durch eine frühere Installation oder Deinstallation der eConnect-App. Wenden Sie sich an den eConnect-Support, um die alte Verbindung zu entfernen und eine neue zu erstellen.

API400: The given action 'booking' is not supported

In der Verbindungskonfiguration ist die Aktion auf „booking" statt „autobooking" gesetzt. Wenden Sie sich an den eConnect-Support, um dies über die Management API zu korrigieren.

Möchten Sie mehr über den Autopilot erfahren? Lesen Sie, wie der Autopilot funktioniert.

Integration starten

Häufig gestellte Fragen
Welches Abonnement benötige ich für die D365 BC-Integration?

Sie benötigen ein Basic-Abonnement bei eConnect. Außerdem benötigen Sie die eConnect-App (kostenlos) aus dem BC AppSource. Die Integration funktioniert über den Autopilot.

Kann ich mehrere BC-Umgebungen verbinden?

Ja, Sie können mehrere Business Central-Umgebungen verbinden. Für jede Umgebung erstellen Sie eine separate Autopilot-Verbindung in der eConnect-Plattform. Verwenden Sie für jede Umgebung eindeutige Anmeldedaten.

Wie sucht eConnect den Lieferanten beim Empfang?

eConnect versucht, den Lieferanten in Business Central über eine feste Suchreihenfolge zu finden: zuerst die Umsatzsteuer-ID, dann die Handelsregisternummer und schließlich die IBAN. Wenn keine dieser Kennungen eine Übereinstimmung ergibt, wird die Rechnung nicht automatisch gebucht, sondern schlägt mit einer Fehlermeldung fehl. Sie können den Lieferanten dann manuell in Business Central anlegen, woraufhin das Dokument erneut eingereicht werden kann.