Die Perk Spend-Integration verbindet Perk mit Microsoft Dynamics 365 Finance (D365 Finance), sodass Kostenobjekte, Tags, Kategorien, Lieferanten und Mitarbeiter automatisch synchronisiert und Ausgaben sowie Rechnungen der richtigen juristischen Person zugerechnet werden. Dieser Artikel führt Sie durch die vollständige Einrichtung – von der Registrierung der App in Entra ID oder AD FS bis zur Überprüfung der ersten Synchronisierung.

Hintergrundinformationen darüber, was die Integration synchronisiert und wie, finden Sie unter Integration mit Microsoft Dynamics 365 Finance für die Spesen- und RechnungsverarbeitungDie

Bevor Sie beginnen

Die Einrichtung der Integration betrifft sowohl Ihre D365 Finance-Umgebung als auch Ihr Perk-Konto. Stellen Sie sicher, dass Sie die aufgeführten Voraussetzungen erfüllen, bevor Sie beginnen. D365 Finance-Voraussetzungen:

• Eine im Einsatz befindliche Version von D365 Finance (keine außer Betrieb genommene Version).
• Eine voll funktionsfähige Kreditorenbuchhaltung Modul, wenn Sie die Rechnungsintegration einrichten.
• Ein voll funktionsfähiges Ausgabenmanagement Modul, wenn Sie die Ausgabenintegration einrichten.
• Für die Registrierung der Anwendung ist ein Entra ID-Zugriff (Cloud) oder ein AD FS-Zugriff (lokal) erforderlich.
• LCS (Lifecycle Services)-Zugriff zum Bereitstellen des Integrationspakets.
• Weisen Sie Ihren Benutzern die richtigen D365 Finance-Sicherheitsrollen zu: eine Integrationsmanagerrolle für Administratoren mit vollem Konfigurationszugriff und eine Integrationsmitarbeiterrolle für Benutzer, die nur Zugriff auf den täglichen Betrieb benötigen. Die Zuweisung erfolgt über die Systemverwaltung unter „Sicherheitsbenutzer“.Die

Anforderungen an die Zusatzleistungen:

• Ein aktives Perk-Konto.
• Kontoadministratorzugriff auf Einstellungen Integrationen um Integrationseinstellungen einzurichten und um Personen Rollen zuweisen.
• Die Client-ID und der Client-Schlüssel aus Ihrer Entra-ID- oder AD FS-App-Registrierung.

Registrieren Sie die App in Entra ID oder AD FS.

Durch die Registrierung einer App erhält Perk eine sichere Identität für den Zugriff auf Ihre D365 Finance-Umgebung. Führen Sie diese Registrierung zuerst durch, da für spätere Schritte die generierte Client-ID und das Client-Geheimnis benötigt werden. Welches System Sie verwenden, hängt von Ihrem Bereitstellungstyp ab: Cloud – D365 Finance verwendet Microsoft Entra ID, lokal – D365 Finance verwendet stattdessen AD FS. Cloud: Registrieren Sie die App in Entra ID

1. Gehen Sie im Azure-Portal zu Microsoft Entra ID, öffnen Sie die Eigenschaften und notieren Sie sich die Verzeichnis-ID (Ihre Mandanten-ID).
2. Gehen Sie zu App-Registrierungen Neue RegistrierungDie
3. Geben Sie einen Namen ein, der die externe Anwendung identifiziert, z. B. Perk IntegrationSie müssen keine Umleitungs-URI festlegen – diese App authentifiziert sich als vertraulicher Client mithilfe eines Client-Geheimnisses, nicht über eine Anmeldeumleitung.
4. Kopieren Sie die Anwendungs-ID (Client-ID) – Sie benötigen sie in späteren Schritten.
5. API-Berechtigungen einrichten: Wählen Sie Berechtigung hinzufügen Microsoft Dynamics ERP (Microsoft.ERP) Delegierte BerechtigungenWählen Sie anschließend Zugriff auf Dynamics AX Custom Service aus.Zugriff auf Dynamics AX-Datenund Greifen Sie als Organisationsbenutzer online auf Dynamics AX zuDie
6. Generieren Sie ein Clientgeheimnis: Gehen Sie zu Zertifikate & Geheimnisse > Neues Clientgeheimnis und legen Sie die Ablaufzeit auf den längsten Zeitraum fest, den die Geheimhaltungsrichtlinie Ihrer Organisation zulässt.

Lokale Installation: Registrieren Sie die App in AD FS. Wenn Ihre D365 Finance-Umgebung lokal ist, registrieren Sie die App bei AD FS anstatt bei Entra ID. Die AD FS-Registrierung ist spezifisch für Ihre lokale Bereitstellung. Befolgen Sie daher die Anweisungen von Microsoft. Dokumentation zur lokalen Bereitstellung und die AD FS-Konfiguration Ihrer Organisation, um die Anwendung zu registrieren und eine Client-ID und ein Client-Geheimnis dafür zu generieren.

Registrieren Sie die App in Dynamics 365 Finance.

D365 Finance benötigt einen eigenen Datensatz der Entra-ID oder AD FS-Anwendung, bevor es Anrufe von Perk entgegennehmen kann. Dadurch wird die Client-ID mit einem Dienstkonto innerhalb von D365 Finance verknüpft.

1. Gehen Sie zu SystemverwaltungSetup Microsoft Entra ID-Anwendungen NeuDie
2. Geben Sie die Client-ID aus Ihrer Entra-ID oder AD FS-App-Registrierung ein.
3. Geben Sie einen Namen für die Anwendung ein.
4. Wählen Sie die entsprechende Benutzer-ID für das Dienstkonto aus.
5. Den Datensatz speichern.

Installieren Sie das Integrationspaket über Lifecycle Services.

Die Integration wird als bereitstellbares Paket bereitgestellt, das Sie über Lifecycle Services (LCS) hochladen und anwenden und anschließend von der Sandbox in die Produktionsumgebung übertragen. Dieser Schritt installiert den Code, der die Integration in D365 Finance ermöglicht. Teil 1: Paket in LCS hochladen

1. Melden Sie sich an bei lcs.dynamics.comDie
2. Wählen Sie das Projekt für Ihre Zielumgebung aus.
3. Gehen Sie zu Weitere Tools Asset-Bibliothek Software-BereitstellungspaketDie
4. Wählen Sie +, um ein neues Paket hinzuzufügen, und geben Sie einen Namen und eine Beschreibung ein.
5. Wählen Sie Datei hinzufügen und laden Sie die Integrationspaket-ZIP-Datei hoch.
6. Wählen Sie „Bestätigen“, um den Upload zu verarbeiten, und warten Sie auf die Validierung – nach Abschluss des Vorgangs wird in der Spalte „Gültig“ ein Häkchen angezeigt.

Teil 2: Wenden Sie das Paket auf Ihre Umgebung an

1. Öffnen Sie die Seite mit den Umgebungsdetails.
2. Gehen Sie zu Wartung und wenden Sie die Aktualisierungen an.Die
3. Geben Sie einen eindeutigen Namen für das Update ein.
4. Wählen Sie das hochgeladene Paket aus der Liste aus.
5. Klicken Sie auf „Anwenden“ und verfolgen Sie den Status, während er sich von „In Warteschlange“ über „In Bearbeitung“ und „Nachbearbeitung“ bis hin zu „Bereitgestellt“ ändert.

Teil 3: Das Update in die Produktion einführen

1. Gehen Sie in der Sandbox-Umgebung zu Verlauf der UmgebungsänderungenDie
2. Wählen Sie das validierte Update aus.
3. Wählen Sie Als Releasekandidaten markierenDie
4. In der Produktionsumgebung gehen Sie zu Umgebung verwalten. Aktualisieren Sie die Umgebung.Die
5. Wählen Sie die Quell-Sandbox und den Release Candidate aus.
6. Planen Sie das Ausfallzeitfenster und wählen Sie „Planen“.

Integrationsparameter in Dynamics 365 Finance festlegen

Die Integrationsparameter legen fest, mit welcher Perk-Organisation und welchen juristischen Personen D365 Finance synchronisiert werden soll und welche Finanzdimensionen und Steuerdaten einbezogen werden sollen. Diese Parameter können auf drei Ebenen konfiguriert werden: Systemebene, Ebene der juristischen Person und globale Integrationsparameter.

1. Systemparameter festlegen: Gehen Sie zu Systemverwaltung SystemparameterÖffnen Sie die Registerkarte „Allgemein“, suchen Sie den Abschnitt „Integration“ und geben Sie die Perk-Organisations-ID ein.
2. Parameter für juristische Personen festlegen: Gehen Sie zu Organisationsverwaltung > Organisationen > Juristische PersonenÖffnen Sie für jede juristische Person, die die Integration nutzt, den Datensatz, suchen Sie den Abschnitt „Integration“ auf der Registerkarte „Allgemein“ und geben Sie die Perk-Rechtseinheiten-ID ein.
3. Globale Integrationsparameter festlegen: Gehen Sie im Bereich „Organisationsverwaltung“ zum Bereich „Parametereinstellungen“ der Integration und nehmen Sie folgende Einstellungen vor.
   • Auf der Registerkarte „Allgemein“ legen Sie den Dokumenttyp fest, der für die Erstellung von Anhängen über die Integration verwendet wird.
   • Auf der Registerkarte „Finanzdimension“ legen Sie den Namen der Finanzdimension fest, die die Kostenstellen darstellt, und verschieben die Dimensionen, die Sie synchronisieren möchten, in das Feld „Ausgewählt“.
   • Wählen Sie auf der Registerkarte „Steuersätze“ die Umsatzsteuergruppen und Artikelumsatzsteuergruppen aus, die Sie synchronisieren möchten. Nur die hier festgelegten Kombinationen werden mit Perk synchronisiert.

Geschäftsereignis-Endpunkte einrichten

Geschäftsereignisse lösen die Echtzeit-Datensynchronisierung von D365 Finance zu Perk aus. Sie richten einen Endpunkt für die meisten Daten ein und aktivieren die einzelnen Geschäftsereignisse, die Sie benötigen.

1. Gehen Sie zu Systemverwaltung > Geschäftsereignisse > Katalog der Geschäftsereignisse > Registerkarte „Endpunkte“ > NeuDie
2. Setzen Sie den Endpunkttyp auf Spend-Connectorund geben Sie ihm einen Namen (zum Beispiel Perk Integration Endpoint).) und Beschreibung.
3. Geben Sie die Authentifizierungs- und Endpunkt-URLs für Ihre Umgebung ein (siehe unten).
4. Fügen Sie den Header X-Yk-Auth-Method:yokoy hinzu. Genau wie angezeigt – dies ist eine feste technische Kopfzeile, die das Integrationspaket erwartet, kein Anzeigename.
5. Geben Sie die Perk-Client-ID und das Perk-Client-Geheimnis ein (generiert in Entwicklertools Ausgabentools Zugangsdaten).

Endpunkt-URLs für die Testumgebung:

• Authentifizierungsendpunkt: https://accounts.test.yokoy.ai/oauth2/token
• Masterdaten-Endpunkt: https://api.test.yokoy.ai/v1
• Anbieter-Endpunkt: https://service.test.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Endpunkt-URLs für die Produktionsumgebung:

• Authentifizierungsendpunkt: https://accounts.yokoy.ai/oauth2/token
• Masterdaten-Endpunkt: https://api.yokoy.ai/v1
• Anbieter-Endpunkt: https://service.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Sobald Ihr Endpunkt eingerichtet ist, aktivieren Sie die benötigten Geschäftsereignisse im Katalog der Geschäftsereignisse:

• Für die Rechnungsintegration: das Lieferantendatenereignis, das Kostenstellendimensionsereignis, das Ereignis anderer Finanzdimensionen, das Beschaffungskategorienereignis, das Bestellbestätigungsereignis, das Wareneingangsereignis, das Zahlungsbedingungenereignis und das Steuersatzereignis.
• Für die Spesenintegration: die Ereignisse „Mitarbeiterdaten“, „Spesenkategorien“ und „Projekte“. Das Ereignis „Kostenstellendimension“ und andere Ereignisse mit Finanzdimensionen werden von beiden Integrationen gemeinsam genutzt.

Sie können Geschäftsereignisse aktivieren, ohne eine juristische Person anzugeben – sie werden für jede juristische Person ausgelöst, die über die erforderliche Integrationskonfiguration verfügt.

Führe die erste Datensynchronisierung durch.

Bevor Sie sich auf die fortlaufende automatische Synchronisierung verlassen, führen Sie einmalige Batch-Jobs aus, um Ihre bestehenden Stammdaten von D365 Finance zu Perk zu übertragen. Sie finden diese Batch-Jobs im Bereich „Batch-Job-Verarbeitung“ der Integration unter „Organisationsverwaltung“. Führen Sie die folgenden Batch-Jobs aus:

• Mitarbeiter, Ausgabenkategorien und Projekte, wenn Sie die Ausgabenintegration einrichten.
• Synchronisierung der Finanzdimensionen für Kostenstellen und andere Finanzdimensionen als benutzerdefinierte Felder.
• Anbieter können über den korrekten Lieferantenendpunkt eine Testanfrage senden. Ausgeschaltet. (Nur Rechnungsverarbeitung)
• Beschaffungskategorien, für die zunächst Rollenzuordnungen in der Kategoriehierarchie eingerichtet werden müssen (nur Rechnungsverarbeitung).
• Steuersätze, die Sie regelmäßig, beispielsweise alle zehn Minuten, ausführen lassen sollten, da Steuersätze nur über Batch-Jobs und nicht über Geschäftsereignisse synchronisiert werden.
• Bestellungen, die nur bestätigte Bestellungen synchronisieren, für die bereits ein Bestätigungsjournal vorliegt (nur Rechnungsverarbeitung).
• Zahlungsbedingungen, die abfragebasiert sind und Filter unterstützen (nur Rechnungsverarbeitung).
• Produktquittungen.

Richten Sie die Integration in Perk ein.

Nachdem D365 Finance eingerichtet ist, schließen Sie die Einrichtung auf der Perk-Seite ab: Verknüpfen Sie Ihre juristischen Personen und richten Sie den Export von Ausgaben und Rechnungen ein.

1. Richten Sie den Firmencode ein: Gehen Sie zu Einstellungen Konto Firmenausgaben-Einstellungen Allgemeinund geben Sie die D365 Finance-Rechtseinheits-ID im Firmencode (ERP) ein. für jede Perk-Rechtseinheit. Dadurch wird sichergestellt, dass Ausgaben und Rechnungen in die richtige D365 Finance-Rechtseinheit exportiert werden.
2. Richten Sie zwei technische benutzerdefinierte Felder im Kostenobjekt ein, die zur Synchronisierung von Kostenstellen und Projekten verwendet werden. Gehen Sie zu Einstellungen Konto Unternehmen Ausgabeneinstellungen und klicken Sie auf Benutzerdefiniertes Feld für Kostenstellen hinzufügen:

1. Ausgabenexport einrichten: Gehen Sie zu EinstellungenIntegrationen > AusgabenexportWählen Sie Finanzen & Betrieb aus. Geben Sie in der ERP-Systemliste die Client-ID und das Client-Geheimnis aus Ihrer Entra-ID- oder AD FS-App-Registrierung ein und wählen Sie „ERP aktualisieren“. Um die Anmeldeinformationen zu speichern, legen Sie anschließend die Token-URL und die Basis-URL (Ihre D365 Finance-Umgebungs-URL) fest:
   • WolkeDie Token-URL lautet https://login.microsoftonline.com/{tenant-id}/oauth2/token, ersetzt {tenant-id} mit Ihrer Entra-ID-Verzeichnis-ID. Die Basis-URL ist die URL Ihrer Cloud-Umgebung, zum Beispiel https://your-company.operations.dynamics.com.Die
   • Vor OrtDie Token-URL ist der Token-Endpunkt Ihres AD FS-Servers und nicht login.microsoftonline.com. — Diese Information erhalten Sie von Ihrem Netzwerk- oder AD FS-Administratorteam. Die Basis-URL ist die URL Ihres lokalen Servers, zum Beispiel: https://your-msd365f-server.yourdomain.comDie

Optional können Sie die Option „Dokumente senden“ aktivieren. Um Belege und Anhänge zu senden, reichen Sie die Ausgabenabrechnung im Bereich Finanzen und Betrieb ein. Um Ausgaben automatisch an den D365 Finance-Workflow zu übermitteln, Steuern in Finanzen und Betrieb einbeziehen Um Steuergruppenfelder zu exportieren und die Zuordnung der Zahlungsmethoden einzurichten, wiederholen Sie dies für jeden Ausgabentyp: erstattungsfähige Ausgaben, Transaktionen und Reisekosten.

1. Rechnungsexport einrichten: Gehen Sie zu Einstellungen Integrationen RechnungsexportWählen Sie Finanzen & Betrieb LieferantenrechnungsexportGeben Sie auf der Registerkarte „Konfiguration“ die Token-URL und die Basis-URL nach demselben Muster wie beim Spesenexport ein – Cloud oder lokal, je nach Ihrer Bereitstellung. Aktivieren Sie optional die Option „Dokumente senden“. und Rechnung im Finanz- und Betriebswesen buchen Um Rechnungen automatisch zu buchen, geben Sie auf der Registerkarte „Autorisierung“ die Kunden-ID und das Kundengeheimnis ein und wählen Sie anschließend „Speichern“, um den Assistenten abzuschließen.
2. Wenn Sie Finanzdimensionen als benutzerdefinierte Felder verwenden, aktivieren Sie Einstellungen Kostenverwaltung Benutzerdefinierte Felder Ihre synchronisierten benutzerdefinierten Felder anzeigen.

Überprüfen Sie die Synchronisierung.

Nachdem die ersten Synchronisierungsläufe abgeschlossen sind, überprüfen Sie, ob die Daten korrekt in Perk übernommen wurden, bevor Sie live gehen. Prüfen Sie dazu die folgenden Bereiche:

• Einstellungen Kostenmanagement Kostenobjektefür Kostenstellen und Projekte.
• Einstellungen Kostenverwaltung Benutzerdefinierte Felder, im Hinblick auf die finanziellen Aspekte.
• Einstellungen Ausgabeneinstellungen Ausgabenkategorien, für Ausgabenkategorien.
• Einstellungen Lieferantenrechnungen Rechnungskategorien, für Beschaffungskategorien.
• Menschen, für Arbeiter und Benutzer.
• Rechnung Lieferantenrechnungen Lieferanten, für Händler.

Falls einer dieser Bereiche leer oder unvollständig erscheint, überprüfen Sie den entsprechenden Batch-Job oder das Geschäftsereignis aus den vorherigen Schritten, bevor Sie die Integration Ihrem gesamten Team zur Verfügung stellen.

Behebung von Konfigurationsproblemen

Hier sind einige mögliche Probleme, auf die Sie stoßen könnten, und wie Sie diese beheben können.

Geschäftsveranstaltungen erreichen Perk nicht.

• Prüfen Sie, ob das Geschäftsereignis in der Systemverwaltung unter „Geschäftsereignisse“ aktiviert ist.Die
• Überprüfen Sie die Endpunktkonfiguration (Authentifizierungs-URL, Endpunkt-URL, Anmeldeinformationen).
• Stellen Sie sicher, dass die juristische Person über die entsprechende Perk-Rechtsträger-ID verfügt.
• Überprüfen Sie das Geschäftsereignisprotokoll auf Fehler.

Die anfängliche Synchronisierung hat keine Daten übertragen

• Prüfen Sie, ob die Parameter für den Batch-Job korrekt eingestellt sind.
• Prüfen Sie, ob der Endpunkt mit dem für diesen Batch-Job erforderlichen übereinstimmt (Anbieter verwenden den separaten Lieferantenendpunkt, bei dem „Testanforderung senden“ deaktiviert ist).
• Stellen Sie sicher, dass das Dienstkonto über ausreichende Berechtigungen verfügt.
• Überprüfen Sie den Verlauf des Batch-Jobs auf Fehlerdetails.

Ausgaben oder Rechnungen werden nicht exportiert

• Überprüfen Sie die Exportkonfiguration in Perk (Token-URL, Basis-URL, Anmeldeinformationen).
• Prüfen Sie bei Ausgaben, ob der Mitarbeiter über eine gültige, aktive D365 Finance-Benutzerverbindung verfügt (oder ob ein Stellvertreter darüber verfügt).
• Prüfen Sie bei Rechnungen, ob der Lieferant in D365 Finance existiert.
• Prüfen Sie die Exportprotokolle auf Fehlerdetails.

Die Steuersätze werden nicht aktualisiert

Die Steuersätze werden über einen geplanten Batch-Job synchronisiert, nicht in Echtzeit.

• Prüfen Sie, ob der Batch-Job zur Berechnung der Steuersätze geplant ist und ausgeführt wird.
• Prüfen Sie, ob in den Integrationsparametern die Kombinationen aus Umsatzsteuergruppe und Artikelumsatzsteuergruppe ausgewählt sind.