Rollen en machtigingen configureren voor de Payhawk-D365 Finance-integratie

Prev Next

Zorg ervoor dat de volgende toegang en instellingen geregeld zijn voordat je Payhawk koppelt aan Microsoft Dynamics 365 Finance.

Wat je nodig hebt

  • Beheerderstoegang tot Microsoft Lifecycle Services (LCS) om de Payhawk-extensie te installeren in je Microsoft Dynamics 365 Finance-omgeving. Zie de Payhawk-extensie installeren voor meer informatie.

  • Een Microsoft Dynamics 365 Finance-account met beheerderstoegang. Met dit account meld je je aan wanneer je de twee systemen koppelt. De rol System administrator is de eenvoudigste optie, maar een aangepaste rol die de Payhawk-extensie dekt, werkt ook.

Azure en Microsoft Entra ID

Je IT-team hoeft geen app-registratie te maken of te beheren in je Azure-tenant. Payhawk maakt verbinding via een eigen Azure-applicatie, die Payhawk registreert en beheert in zijn eigen Microsoft Entra-tenant.

Je IT-team hoeft het volgende niet te doen:

  • Een app-registratie maken

  • Een clientgeheim of certificaat genereren

  • Omleidings-URI's of API-machtigingen configureren

  • Een applicatie registreren onder System administration > Setup > Microsoft Entra applications in Microsoft Dynamics 365 Finance

Als je tenant gebruikers niet toestaat toestemming te geven aan apps van derden, toont Microsoft een goedkeuringsverzoek wanneer het account zich aanmeldt tijdens het koppelen. Een Microsoft Entra-beheerder keurt dit eenmalig goed. Verdere Azure-configuratie is niet nodig.

Technische details voor je IT-team:

  • Eigenaar van de applicatie - Payhawk, geregistreerd en beheerd in de eigen Microsoft Entra-tenant van Payhawk

  • Autoriteit - https://login.microsoftonline.com/common/oauth2/v2.0

  • Granttype - OAuth 2.0-autorisatiecode, gedelegeerd (namens de aangemelde gebruiker)

  • Aangevraagde scopes - https://<your environment URL>/.default en offline_access

  • Omleidings-URI - https://microsoft-dynamics-fo-adapter.payhawk.com/callback

  • Gegevens waartoe Payhawk toegang heeft - Alleen je Microsoft Dynamics 365 Finance-omgeving, binnen de beveiligingsrollen van het account dat zich aanmeldt

  • Door Payhawk opgeslagen inloggegevens - Alleen OAuth-tokens, geen wachtwoorden

Het integratieaccount

Payhawk werkt in Microsoft Dynamics 365 Finance als het account dat zich aanmeldt tijdens het koppelen. Elk record dat Payhawk aanmaakt, is in de audittrail van Microsoft Dynamics 365 Finance herleidbaar tot dat account.

We raden een apart account aan, bijvoorbeeld payhawk.integration@yourcompany.com, in plaats van het account van een persoon, zodat de koppeling blijft werken wanneer mensen vertrekken of van rol veranderen. Het account moet:

  • Bestaan in je Microsoft Entra ID.

  • Ingeschakeld zijn in Microsoft Dynamics 365 Finance, met toegang tot de juridische entiteit die je koppelt.

  • Eenmalig een interactieve aanmelding kunnen voltooien.

Payhawk gebruikt het account om:

  • Toegang te krijgen tot financiële dimensies

  • Toegang te krijgen tot belastingtarieven

  • Toegang te krijgen tot leveranciers

  • Toegang te krijgen tot GL-codes/-projecten

  • Journaalkoppen te maken

  • Journaalposten te maken

  • Bijlagen toe te voegen

Als het account wordt uitgeschakeld, het wachtwoord opnieuw wordt ingesteld of de sessies worden ingetrokken, stopt de koppeling. Om deze te herstellen, koppelt een Payhawk-beheerder opnieuw via instellingen > integraties.

Na de eerste aanmelding vernieuwt Payhawk zijn toegang op de achtergrond vanaf zijn eigen servers. Beleid voor voorwaardelijke toegang dat herhaalde MFA, een korte aanmeldfrequentie, een compatibel apparaat of een vertrouwd netwerk vereist, blokkeert deze vernieuwingen en verbreekt de koppeling. Sluit het integratieaccount uit van dit beleid of sta de Payhawk-applicatie hierin toe.

Instellingen in Microsoft Dynamics 365 Finance

De journaals en boekingsinstellingen maken geen deel uit van de Payhawk-koppelingswizard. Je stelt ze in op de pagina Payhawk Parameters in Microsoft Dynamics 365 Finance, die met de extensie wordt geïnstalleerd:

  • Leveranciersbetalingsjournaal

  • Algemene journaals en grootboekjournaals

  • Stortingsjournaal

  • Standaardbetaalmethode

  • Kostenrekening

  • Btw-groep

  • Banktransactietypen

Je kunt de twee systemen koppelen voordat je deze instellingen invult, maar exports naar Microsoft Dynamics 365 Finance mislukken totdat je dat doet. Zie de Payhawk-extensie configureren voor meer informatie.

Voordat je koppelt

  • De Payhawk-extensie is geïnstalleerd en de pagina Payhawk Parameters opent en is ingevuld.

  • De persoon met beheerderstoegang tot Microsoft Dynamics 365 Finance is beschikbaar om zich aan te melden tijdens het koppelen.

  • Een Payhawk-beheerder is beschikbaar om de koppeling uit te voeren. Dit kan dezelfde persoon zijn.

  • Je hebt de URL van je Microsoft Dynamics 365 Finance-omgeving. Deze eindigt op .dynamics.com, bijvoorbeeld contoso.operations.dynamics.com.

  • Je financeteam heeft de structuur van de financiële dimensies gekozen.

Tijdens de koppeling met Microsoft Dynamics 365 Finance voer je de volgende stappen uit:

  1. Authenticeren.

  2. Rekeningen koppelen.

  3. Initiële datasynchronisatie uitvoeren.

Vervolgstappen