De Perk Spend-integratie verbindt Perk met Microsoft Dynamics 365 Finance (D365 Finance), waardoor kostenobjecten, tags, categorieën, leveranciers en medewerkers automatisch worden gesynchroniseerd en onkosten en facturen naar de juiste juridische entiteit worden geëxporteerd. Dit artikel beschrijft de volledige installatie, van het registreren van de app in Entra ID of AD FS tot het controleren van de eerste synchronisatie.

Voor meer informatie over wat de integratie synchroniseert en hoe, zie Integreer met Microsoft Dynamics 365 Finance voor de verwerking van onkosten en facturen..

Voordat je begint

Het instellen van de integratie heeft gevolgen voor zowel uw D365 Finance-omgeving als uw Perk-account. Zorg ervoor dat u aan de vermelde vereisten voldoet voordat u begint. Vereisten voor D365 Finance:

• Een versie van D365 Finance die nog in gebruik is (geen versie die niet meer in gebruik is).
• Een volledig functionele Crediteurenadministratie module, als je de factuurintegratie instelt.
• Een volledig functioneel kostenbeheersysteem module, als je de onkostenintegratie instelt.
• Toegang tot Entra ID (cloud) of AD FS (on-premises) is vereist om de applicatie te registreren.
• Toegang tot LCS (Lifecycle Services) is vereist om het integratiepakket te implementeren.
• De juiste D365 Finance-beveiligingsrollen toewijzen aan uw gebruikers: een rol voor integratiebeheerder voor beheerders die volledige configuratietoegang nodig hebben, en een rol voor integratiemedewerker voor mensen die alleen toegang nodig hebben voor dagelijkse werkzaamheden. Wijs deze rollen toe via Systeembeheer Beveiligingsgebruikers.

Voorwaarden voor extraatjes:

• Een actief Perk-account.
• Accountbeheerderstoegang tot Instellingen Integraties om integratie-instellingen te configureren, en om Mensen rollen toewijzen.
• De Client ID en Client Secret van uw Entra ID of AD FS app-registratie.

Registreer de app in Entra ID of AD FS.

Door een app te registreren, geeft u Perk een veilige identiteit waarmee het verbinding kan maken met uw D365 Finance-omgeving. Doe dit eerst, aangezien latere stappen de Client ID en Client Secret vereisen die hiermee worden gegenereerd. Het systeem dat u gebruikt, is afhankelijk van uw implementatietype: in de cloud gebruikt D365 Finance Microsoft Entra ID, en on-premises gebruikt D365 Finance in plaats daarvan Active Directory FS. Cloud: registreer de app in Entra ID

1. Ga in de Azure-portal naar Microsoft Entra ID, open Eigenschappen en noteer de Directory ID (uw tenant-ID).
2. Ga naar App-registraties Nieuwe registratie.
3. Voer een naam in waarmee de externe applicatie kan worden geïdentificeerd, bijvoorbeeld Perk IntegrationJe hoeft geen omleidings-URI in te stellen; deze app authenticeert zich als een vertrouwelijke client met behulp van een clientgeheim, niet via een aanmeldingsomleiding.
4. Kopieer de applicatie-ID (client-ID) — u hebt deze in latere stappen nodig.
5. API-machtigingen instellen: selecteer Een machtiging toevoegen Microsoft Dynamics ERP (Microsoft.ERP) Gedelegeerde machtigingenSelecteer vervolgens Toegang tot Dynamics AX-aangepaste service., Toegang tot Dynamics AX-gegevensen Toegang tot Dynamics AX online als organisatiegebruikers.
6. Een clientgeheim genereren: ga naar Certificaten en geheimen, Nieuw clientgeheim en stel de vervaldatum in op de langste periode die is toegestaan ​​volgens het geheimbeleid van uw organisatie.

On-premises: registreer de app in AD FS Als uw D365 Finance-omgeving on-premises is, registreer de app dan bij AD FS in plaats van Entra ID. De AD FS-registratie is specifiek voor uw on-premises implementatie, dus volg de instructies van Microsoft. documentatie voor implementatie op locatie en de AD FS-configuratie van uw organisatie om de toepassing te registreren en een client-ID en clientgeheim ervoor te genereren.

Registreer de app in Dynamics 365 Finance.

D365 Finance heeft een eigen registratie van de Entra ID of AD FS-applicatie nodig voordat het oproepen van Perk kan accepteren. Dit koppelt de klant-ID aan een serviceaccount binnen D365 Finance.

1. Ga naar Systeembeheer Microsoft Entra ID-toepassingen instellen Nieuw.
2. Voer de klant-ID in die u hebt ontvangen bij uw Entra-ID of AD FS-appregistratie.
3. Geef de applicatie een naam.
4. Selecteer de juiste gebruikers-ID voor het serviceaccount.
5. Bewaar de opname.

Installeer het integratiepakket via Lifecycle Services.

De integratie wordt geleverd als een implementeerbaar pakket dat u uploadt en toepast via Lifecycle Services (LCS), waarna u het pakket promoveert van de sandbox-omgeving naar de productieomgeving. In deze stap wordt de code geïnstalleerd die de integratie in D365 Finance mogelijk maakt. Deel 1: Het pakket uploaden naar LCS

1. Log in bij lcs.dynamics.com.
2. Selecteer het project dat geschikt is voor uw doelomgeving.
3. Ga naar Meer tools Assetbibliotheek Software-implementatiepakket.
4. Selecteer + om een ​​nieuw pakket toe te voegen en voer een naam en beschrijving in.
5. Selecteer Een bestand toevoegen en upload het ZIP-bestand van het integratiepakket.
6. Selecteer 'Bevestigen' om de upload te verwerken en wacht op de validatie. Er verschijnt een vinkje in de kolom 'Geldig' wanneer de validatie is voltooid.

Deel 2: Pas het pakket toe in uw omgeving

1. Open de pagina met omgevingsdetails.
2. Ga naar Onderhoud Updates toepassen.
3. Geef de update een unieke naam.
4. Selecteer het geüploade pakket uit de lijst.
5. Selecteer Toepassen en volg de status terwijl deze verandert van In de wachtrij naar Verwerking, Na verwerking en Uiteindelijk geïmplementeerd.

Deel 3: De update naar productie brengen

1. Ga in de sandbox-omgeving naar Geschiedenis Omgevingswijzigingen.
2. Selecteer de gevalideerde update.
3. Selecteer Markeer als releasekandidaat.
4. Ga in de productieomgeving naar Omgeving onderhouden.
5. Selecteer de bron-sandbox en de releasekandidaat.
6. Plan het onderhoudsvenster in en selecteer 'Plannen'.

Integratieparameters instellen in Dynamics 365 Finance

Integratieparameters geven D365 Finance aan met welke Perk-organisatie en juridische entiteiten gesynchroniseerd moet worden, en welke financiële dimensies en belastinggegevens moeten worden opgenomen. Stel deze parameters in op drie niveaus: systeem, juridische entiteit en algemene integratieparameters.

1. Stel systeemparameters in: ga naar Systeembeheer SysteemparametersOpen het tabblad Algemeen, zoek het gedeelte Integratie en voer de Perk-organisatie-ID in.
2. Stel de parameters van de rechtspersoon in: ga naar Organisatiebeheer Organisaties RechtspersonenVoor elke juridische entiteit die de integratie gebruikt, opent u het record, zoekt u het gedeelte 'Integratie' op het tabblad 'Algemeen' en voert u de Perk-ID van de juridische entiteit in.
3. Globale integratieparameters instellen: ga naar het gedeelte voor het instellen van de integratieparameters onder Organisatiebeheer en stel de volgende parameters in.
   • Stel op het tabblad Algemeen het documenttype in dat wordt gebruikt voor het maken van bijlagen via de integratie.
   • Stel op het tabblad Financiële dimensie de naam in van de financiële dimensie die kostenplaatsen vertegenwoordigt en verplaats de dimensies die u wilt synchroniseren naar het vak Geselecteerd.
   • Selecteer op het tabblad 'Belastingtarieven' de btw-groepen en btw-groepen per artikel die u wilt synchroniseren. Alleen de combinaties die u hier instelt, worden gesynchroniseerd met Perk.

Stel eindpunten voor zakelijke gebeurtenissen in.

Bedrijfsevenementen zijn de triggers voor realtime gegevenssynchronisatie van D365 Finance naar Perk. U configureert één eindpunt voor de meeste gegevens en activeert de individuele bedrijfsevenementen die u nodig hebt.

1. Ga naar Systeembeheer > Bedrijfsevenementen > Catalogus van bedrijfsevenementen > Tabblad Eindpunten > Nieuw.
2. Stel het eindpunttype in op Spend connectoren geef het een naam (bijvoorbeeld Perk Integration Endpoint)) en beschrijving.
3. Voer de authenticatie- en eindpunt-URL's voor uw omgeving in (zie hieronder).
4. Voeg de header X-Yk-Auth-Method:yokoy Precies zoals weergegeven — dit is een vaste technische koptekst die het integratiepakket verwacht, geen weergavenaam.
5. Voer de Perk Client ID en Perk Client Secret in (gegenereerd in Ontwikkelaarstools Uitgaventools Toegangsgegevens).

Eindpunt-URL's voor de testomgeving:

• Authenticatie-eindpunt: https://accounts.test.yokoy.ai/oauth2/token
• Masterdata-eindpunt: https://api.test.yokoy.ai/v1
• Leveranciers-eindpunt: https://service.test.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Eindpunt-URL's voor de productieomgeving:

• Authenticatie-eindpunt: https://accounts.yokoy.ai/oauth2/token
• Masterdata-eindpunt: https://api.yokoy.ai/v1
• Leveranciers-eindpunt: https://service.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Zodra uw eindpunt is ingesteld, activeert u de gewenste bedrijfsevenementen in de catalogus met bedrijfsevenementen:

• Voor de factuurintegratie: de volgende gebeurtenissen: leveranciersgegevens, kostenplaatsdimensie, overige financiële dimensies, inkoopcategorieën, orderbevestiging, productontvangst, betalingsvoorwaarden en belastingtarief.
• Voor de onkostenintegratie: de gebeurtenis met werknemersgegevens, de gebeurtenis met onkostencategorieën en de gebeurtenis met projecten. De gebeurtenis met de kostenplaatsdimensie en andere financiële dimensies worden gedeeld tussen beide integraties.

U kunt bedrijfsevenementen activeren zonder een rechtspersoon op te geven; ze worden geactiveerd voor elke rechtspersoon die de vereiste integratieconfiguratie heeft.

Voer de eerste gegevenssynchronisatie uit.

Voordat u vertrouwt op doorlopende automatische synchronisatie, voert u eenmalige batchtaken uit om uw bestaande stamgegevens van D365 Finance naar Perk over te zetten. U vindt deze batchtaken in het gedeelte voor batchverwerking van de integratie onder Organisatiebeheer. Voer de volgende batchtaken uit:

• Werknemers, onkostencategorieën en projecten, als u de onkostenintegratie instelt.
• Synchronisatie van financiële dimensies voor kostenplaatsen en andere financiële dimensies als aangepaste velden.
• Leveranciers, die het juiste leveranciers-eindpunt gebruiken, met Verzend testverzoek uitgeschakeld. (alleen factuurverwerking)
• Inkoopcategorieën, waarvoor eerst de rolkoppelingen in de categoriehiërarchie moeten worden ingesteld. (alleen voor factuurverwerking)
• Belastingtarieven, die u bijvoorbeeld elke tien minuten periodiek moet laten uitvoeren, aangezien belastingtarieven alleen via batchverwerking worden gesynchroniseerd en niet via zakelijke gebeurtenissen.
• Inkooporders, die alleen bevestigde inkooporders synchroniseren waarvoor al een bevestigingsjournaal bestaat. (alleen factuurverwerking)
• Betalingsvoorwaarden, die op basis van een zoekopdracht worden verwerkt en filtering ondersteunen. (alleen voor factuurverwerking)
• Productbonnen.

Stel de integratie in Perk in.

Nadat D365 Finance is ingesteld, kunt u de configuratie aan de Perk-kant voltooien: koppel uw rechtspersoonlijkheden en stel de export van onkosten en facturen in.

1. Stel de bedrijfscode in: ga naar Instellingen Account Bedrijf Uitgaveninstellingen Algemeenen voer de D365 Finance-identificatiecode voor de juridische entiteit in bij Bedrijfscode (ERP) voor elke Perk-rechtspersoon. Dit zorgt ervoor dat onkosten en facturen naar de juiste D365 Finance-rechtspersoon worden geëxporteerd.
2. Stel twee technische aangepaste velden in voor het kostenobject. Deze velden worden gebruikt voor het synchroniseren van kostenplaatsen en projecten. Ga naar Instellingen > Rekening > Bedrijven > Uitgaveninstellingen en klik op Aangepast veld kostenplaatsen toevoegen:

1. De export van onkosten instellen: ga naar Instellingen Integraties > Onkostenexport, selecteer Financiën en bedrijfsvoering Selecteer in de lijst met ERP-systemen de Client ID en Client Secret uit uw Entra ID of AD FS-appregistratie en selecteer ERP bijwerken. Om de inloggegevens op te slaan, stelt u vervolgens de token-URL en de basis-URL (de URL van uw D365 Finance-omgeving) in:
   • WolkDe token-URL is https://login.microsoftonline.com/{tenant-id}/oauth2/token, ter vervanging van {tenant-id} met uw Entra ID Directory ID. De basis-URL is de URL van uw cloudomgeving, bijvoorbeeld https://uw-bedrijf.operations.dynamics.com.
   • Op locatieDe token-URL is het token-eindpunt van uw AD FS-server in plaats van login.microsoftonline.com — Vraag dit aan uw netwerkbeheerder of AD FS-beheerdersteam. De basis-URL is de URL van uw on-premises server, bijvoorbeeld https://uw-msd365f-server.uwdomein.com.

Schakel eventueel de functie 'Documenten verzenden' in. Om bonnen en bijlagen te verzenden, Declaratie indienen bij Financiën en Bedrijfsvoering Om onkosten automatisch in te dienen bij de D365 Finance-workflow, Voeg belasting toe in Financiën en Bedrijfsvoering Exporteer de velden van de belastinggroep en stel de koppeling van betaalmethoden in. Herhaal dit voor elk type uitgave: vergoedbare uitgaven, transacties en reiskosten.

1. Factuurexport instellen: ga naar Instellingen Integraties Factuurexport, selecteer Financiën & Bedrijfsvoering Leveranciersfactuur exporterenVoer op het tabblad Configuratie de Token-URL en de Basis-URL in volgens hetzelfde patroon als bij het exporteren van onkosten – cloud of on-premises, afhankelijk van uw implementatie. Schakel optioneel Documenten verzenden in. en Factuur boeken in Financiën en Bedrijfsvoering Om facturen automatisch te boeken. Voer op het tabblad Autorisatie de klant-ID en het klantgeheim in en selecteer vervolgens Opslaan om de wizard te voltooien.
2. Als u financiële dimensies als aangepaste velden gebruikt, vink dan Instellingen > Kostenbeheer > Aangepaste velden aan. om uw gesynchroniseerde aangepaste velden te bekijken.

Controleer de synchronisatie

Controleer na de eerste synchronisatie of de gegevens correct in Perk zijn aangekomen voordat u live gaat. Controleer de volgende punten:

• Instellingen Kostenbeheer Kostenobjecten, voor kostenplaatsen en projecten.
• Instellingen Kostenbeheer Aangepaste velden, voor financiële aspecten.
• Instellingen > Uitgaveninstellingen > Uitgavencategorieën, voor onkostencategorieën.
• Instellingen Leveranciersfacturen Factuurcategorieën, voor inkoopcategorieën.
• Mensen, voor werknemers en gebruikers.
• Factuur Leveranciersfacturen Leveranciers, voor leveranciers.

Als een van deze gebieden leeg of onvolledig lijkt, ga dan terug en controleer de bijbehorende batchtaak of bedrijfsgebeurtenis uit de eerdere stappen voordat u de integratie uitrolt naar uw bredere team.

Problemen met de configuratie oplossen

Hieronder vindt u een aantal mogelijke problemen die u kunt tegenkomen en hoe u deze kunt oplossen.

Zakelijke evenementen bereiken Perk niet.

• Controleer of de bedrijfsgebeurtenis is geactiveerd in Systeembeheer Bedrijfsgebeurtenissen.
• Controleer de endpointconfiguratie (authenticatie-URL, endpoint-URL, inloggegevens).
• Zorg ervoor dat de juridische entiteit de juiste Perk-identificatiecode heeft.
• Controleer het logboek met bedrijfsevenementen op fouten.

De eerste synchronisatie heeft geen gegevens overgezet.

• Controleer of de parameters voor de batchtaak correct zijn ingesteld.
• Controleer of het eindpunt overeenkomt met het eindpunt dat nodig is voor die batchtaak (leveranciers gebruiken het aparte leverancierseindpunt, waarbij 'Testverzoek verzenden' is uitgeschakeld).
• Zorg ervoor dat het serviceaccount voldoende machtigingen heeft.
• Raadpleeg de batchtaakgeschiedenis voor details over eventuele fouten.

Uitgaven of facturen worden niet geëxporteerd.

• Controleer de exportconfiguratie in Perk (token-URL, basis-URL, inloggegevens).
• Controleer voor onkostenvergoedingen of de medewerker een geldige, actieve D365 Finance-gebruikersverbinding heeft (of een gemachtigde die dat heeft).
• Controleer voor facturen of de leverancier in D365 Finance is geregistreerd.
• Raadpleeg de exportlogboeken voor details over de fouten.

De belastingtarieven worden niet bijgewerkt.

Belastingtarieven worden gesynchroniseerd via een geplande batchtaak, niet in realtime.

• Controleer of de batchtaak voor het berekenen van de belastingtarieven is ingepland en wordt uitgevoerd.
• Controleer of de combinaties van omzetbelastinggroep/artikelomzetbelastinggroep zijn geselecteerd in de integratieparameters.