Voor Microsoft Dynamics 365 Business Central On-Premise-implementaties installeert u de Perk Spend Management Connector als een extensie.

Voorzichtigheid: Door de Perk-connector als extensie te installeren, dient u er rekening mee te houden dat deze geen automatische updates met nieuwe functies ontvangt. U bent zelf verantwoordelijk voor het installeren en beheren van eventuele updates voor de Perk-connector.

De extensie moet worden geregistreerd en geconfigureerd bij Microsoft Entra om Perk toegang te geven tot de API-eindpunten van Business Central.

Om de connector voor Business Central On Premises in te stellen:

1. Installeer de extensie.
2. Business Central instellen voor Microsoft Entra.
3. Configureer de connector in Business Central..
4. Exporteren instellen in Perk:
   1. kosten exporteren
   2. factuur exporteren
5. Synchroniseer stam- en transactiegegevens..

Let op: De on-premises versie van Business Central kan worden gehost op privéwebservers met beperkte toegang van en naar onbeveiligde netwerken. Zorg ervoor dat het beveiligingsbeleid de uitwisseling van verkeer tussen Perk en de services van de Business Central-tenant niet blokkeert.
Met andere woorden: firewallregels, port forwarding-regels en beveiligde netwerkgateways moeten zo worden ingesteld dat verkeer van en naar Business Central On-premises en Perk kan worden doorgestuurd voordat de gegevenssynchronisatie of export kan worden gestart.

Architectonisch overzicht

Om gegevens uit te wisselen tussen Perk en Microsoft Dynamics 365 Business Central, gebruikt de applicatie OAuth 2.0-authenticatie en -autorisatie om de gegevensoverdracht te beveiligen.

Microsoft Entra wordt gebruikt als identiteitsprovider (IdP). Het beheert op veilige wijze gebruikersinformatie, toegangsrechten en de vertrouwensrelaties tussen Business Central en Perk. Nadat een gebruiker zich heeft geauthenticeerd (d.w.z. is ingelogd), geeft de autorisatieserver beveiligingstokens uit die de clientapplicatie (d.w.z. de Perk-webapp) gebruikt om toegang tot de Business Central API te verlenen, te weigeren of in te trekken (autorisatie). Zodra de clientapplicatie geldige bearer-tokens (toegang, ID en vernieuwing) heeft, kan deze de gegevens in Business Central benaderen en bewerkingen uitvoeren zoals aanmaken, bijwerken of verwijderen. Met andere woorden, wanneer de Perk-app API-aanroepen naar Business Central doet, controleert de extensie de verstrekte toegangstokens en bepaalt of toegang tot de gevraagde resources moet worden toegestaan ​​of geweigerd. Indien toegang is toegestaan, kan Perk vervolgens onkosten of facturen boeken.

Daarom moet u Microsoft Entra zo instellen dat de client-app (Perk) wordt herkend en dat er beveiligingstokens worden uitgegeven.

Installeer de Perk-connector als een verlengstuk.

Om de Perk-connector als extensie te installeren, moet u toegang hebben tot het connectorpakket (.app). U moet Een serviceverzoek indienen om toegang te krijgen tot het connectorpakket.

Zodra je toegang hebt tot dit bestand, kun je verdergaan met installeer de app met behulp van de Voortplantingsbeheer pagina.

Het uitbreidingspakket gebruikt deze ID-bereiken voor de onderstaande objecten:

Opmerking: ID-bereiken zijn dynamisch en kunnen worden beïnvloed door uw licentie.
Als u deze ID-bereiken gebruikt, moet u mogelijk een ander bereik toewijzen aan de objecten van het extensiepakket. Anders ontstaan ​​er conflicten.

Extensies kunnen na een update van Business Central automatisch worden verwijderd zonder gegevensverlies. Zie De extensie verwijderen.

Business Central instellen voor Microsoft Entra

Nadat je de extensie hebt geïnstalleerd, moet je het volgende doen: register En configureer het In Microsoft Entra moet je Perk toegang geven tot de Business Central API-eindpunten. Je moet ook het volgende doen: configureer de app-machtigingen.

Let op: Het is van groot belang dat u de stappen volgt die in de handleiding worden beschreven. Officiële Microsoft-documentatiemet name de secties Business Central Server configureren en Business Central Webservercomponent configureren

Om de door Microsoft Entra uitgegeven beveiligingstokens te vertrouwen, moet u uw app registreren. Tijdens de registratie kent het platform sleutelwaarden toe, zoals:

• Applicatie-ID (client-ID):Deze unieke identificatiecode, ook wel applicatie-ID of client-ID genoemd, wordt door het identiteitsplatform aan uw app toegewezen. De client-ID helpt uw ​​applicatie binnen het platform te identificeren en is opgenomen in de beveiligingstokens die door het platform worden uitgegeven.
• Omleidings-URI: De omleidings-URI geeft aan waar de autorisatieserver de gebruiker (bijvoorbeeld een webbrowser of mobiele app) na het voltooien van het authenticatieproces naartoe moet sturen. Nadat de gebruiker bijvoorbeeld is ingelogd, stuurt de autorisatieserver hem of haar door naar de opgegeven URI. Houd er rekening mee dat niet alle clienttypen een omleidings-URI vereisen.

App-registratie biedt ook de authenticatie- en autorisatie-eindpunten die nodig zijn om ID- en toegangstokens te verkrijgen.

Registreer een applicatie op de MS Azure-portal.

Je moet eerst een app registreren in de MS Azure-portal voor de Perk-connector.
Zien Registreer een app in het Microsoft-identiteitsplatform. voor begeleiding.

Definieer de basisfunctionaliteit van de applicatie door de configuratie in te stellen. Overzicht, Authenticatie, Certificaten en geheimen, En API-toestemming secties.

Overzicht sectie:

• Naam van de appPerk Business Central-connector
• Applicatie (client-ID)Kopieer deze ID, je hebt hem later nodig.

Authenticatie tab:

Klik + Een platform toevoegen.

1. Select Web.
2. Binnenkomen Omleidings-URI's:
   • https:///BC230/SignIn
   • https:///BC230/auth-response
   • https:///BC230/OAuthLanding.htm
   • https://test.yokoy.ai/oauth2/callback (test) of https://app.yokoy.ai/oauth2/callback (productie)
3. Klik op Opslaan.

Tip: Om meerdere omleidings-URI's toe te voegen, moet u er eerst één toevoegen en vervolgens klikken. ReddenVervolgens kun je de tweede toevoegen aan het hoofdscherm.

API-machtigingen sectie:

1. Klik + Een toestemming toevoegen.
2. Select Dynamics 365 Business Central.
3. In Gedelegeerde machtigingen, selecteer en voeg machtigingen toe:
   • gebruiker_imitatie
   • Financiën.LezenSchrijven.Alles
4. In Applicatierechten, selecteer en voeg machtigingen toe:
   • app_access
   • AdminCenter.ReadWrite.All
   • API.ReadWrite.All
5. Klik Geef beheerders toestemming voor…

Certificaten en geheimen sectie:

Maak een nieuw clientgeheim aan. We raden aan de vervaldatum in te stellen op 24 maanden. Kopieer de Waarde En Geheime ID.

Publiceer de webservice in Business Central.

Binnenkomen "Microsoft Entra-applicatiesTyp "" in de wereldwijde zoekfunctie van Business Central (rechtsboven) om de applicatie-instellingen te openen.

Maak de applicatie aan

U moet een nieuwe applicatie aanmaken in Business Central:

1. Maak een nieuwe aanvraagkaart aan.
2. Voer de applicatie-ID in (gemaakt in het gedeelte Overzicht in de Azure-portal) in Client ID.
3. Binnenkomen Perk for Business Central in de beschrijving.
4. Selecteer onder 'Status' de optie 'Ingeschakeld'.

Wijs gebruikersrechten toe in Business Central.

Je moet de applicatie zo instellen dat deze beschikt over... superbeheerdersrechten.

Meer specifiek moet u deze machtigingensets toevoegen in de Gebruikersgroepen sectie in de Microsoft Entra-toepassingskaart die u zojuist hebt gemaakt.

Nadat de initiële installatie is voltooid, hebben standaardgebruikers de Perk BC-machtigingenset (PERMISSIONSET YKY) nodig om latere wijzigingen in de integratie aan te brengen en gegevens te synchroniseren.

Daarnaast moet u het ID-bereik bepalen waarop nieuwe objecten kunnen worden aangemaakt (bijvoorbeeld 50000 tot 55000).

Aangezien het ID-bereik dat voor maatwerkontwikkelingen wordt gebruikt kan variëren, is het belangrijk dit bereik te specificeren, omdat het installatiepakket bestaande objecten met hetzelfde ID-bereik zal overschrijven. Zie Installeer de connector als een verlengstuk. Voor een lijst met de ID-bereiken die standaard in de extensie worden gebruikt.

Webservices configureren

U moet in Business Central de webservices toevoegen voor elke module die u wilt integreren (bijvoorbeeld één webservice voor factuurverwerking en een andere voor onkostenverwerking).

Om dit te doen:

1. Ga naar Webdiensten.
2. Klik + Nieuw om een nieuw object te maken.
3. Selecteer de Codeunit-objecttype.
4. Zoek naar de object-ID's afhankelijk van de module die u wilt implementeren:
   • Uitgavenverwerking: Uitgaven importeren YKY (63807)
   • Factuurverwerking: Webhooks YKY (63806)
5. Voer een unieke servicenaam in (bijv. factuurverwerking of onkostenverwerking). Zorg ervoor dat de Gepubliceerd Het selectievakje is aangevinkt.

Als je dit gedaan hebt, moet je configureer de pagina 'Perk Integrations Setup' in Business Central voordat u verdergaat met het instellen van de export van onkosten of facturen in Perk.

Stel de onkostenexport in Perk in.

Perk is verantwoordelijk voor het exporteren van de onkostengegevens naar het grootboek in Business Central. Onkostenbonnen en bijlagen kunnen naar behoefte aan journaalposten worden gekoppeld.

Als het bedrijf van plan is creditnota's te verwerken, moet u creditnota's voor de betreffende rechtspersoon hebben ingeschakeld.

U moet het tabblad 'Uitgaven exporteren' (Beheer > Integraties, Uitgaven exporteren) instellen om uitgavengegevens (uitgaven, kaarttransacties, reiskosten) naar Business Central te verzenden.

Let op: U kunt de Perk-connector niet gebruiken om dagvergoedingen/kilometervergoedingen afzonderlijk te exporteren.

Om dit te doen:

1. Ga naar Instellingen > Integraties.
2. Selecteer de kaart Uitgaven exporteren.
3. Kiezen Business Central [API] als de ERP-systeem.
4. Voer de authenticatiegegevens in:
   • Azure Directory ID: Business Central tenant-ID
   • Client-ID: MS Azure-portal client-ID die eerder is aangemaakt
   • Clientgeheim: MS Azure-portal clientgeheim dat eerder is aangemaakt
5. Klik Meld u aan met Business Central.

Zorg ervoor dat Schakel eventuele pop-upblokkers uit. In uw browservenster. MS Dynamics-authenticatie maakt gebruik van een pop-upvenster om het authenticatieverzoek naar MS Entra te verzenden.

Voorzichtigheid: Zorg ervoor dat u het juiste ERP-systeem selecteert! MS Dynamics Cloud & MS Dynamic OnPrem Dit zijn de exportmogelijkheden voor een andere MS Dynamics Business Central-connector, niet voor de door Perk ontwikkelde connector.

Zodra de verbinding tot stand is gebracht, kunt u de exportinstellingen configureren:

Waarschuwing: De instelling voor het exporteren van onkosten Kostenobjecten uitsluiten van export is niet compatibel met deze integratie. De Perk-integratie voor MS Dynamics 365 Business Central verwacht altijd een kostenobject bij het exporteren van onkosten.

Stel de factuurexport in Perk in.

Om facturen met Business Central te verwerken, gebruikt Perk webhooks om Business Central op de hoogte te stellen van wijzigingen in de documentstatus. Perk beschikt over een specifieke exportfunctie voor facturen om de webhook-respons af te handelen. Momenteel zijn de webhooks synchroon. Dit betekent dat de provider moet wachten tot de webhook de verwerking heeft voltooid voordat een reactie wordt ontvangen.

Om Business Central met Perk te laten verbinden, moet u de integratie in Perk instellen:

1. Ga naar Instellingen > Integraties .
2. Selecteer de kaart Factuurexports.
3. Vul deze gegevens in:
   • Exportnaam: Facturen van Business Central
   • Documenttype: Facturen van leveranciers
4. In Systeem tab, selecteren Business Central-integratie.
5. In Configuratie Voer op het tabblad de gegevens in die worden gebruikt om de URL te vormen waarmee u toegang krijgt tot de Business Central API. U moet de volgende gegevens invoeren:

Je moet dit doen voor elke rechtspersoon die u wilt koppelen aan een bedrijf in Business Central.

Waarschuwing: Als u meerdere exportfaciliteiten probeert in te stellen (bijvoorbeeld de Perk-connector samen met bestaande integraties), kunt u de volgende foutmelding krijgen: Validatie: Meerdere exportfaciliteiten van toepassing Wanneer u een factuur probeert te exporteren, kunt u slechts één exportfunctie tegelijk actief hebben.

Tip: Volgende stap: Stam- en transactiegegevens instellen en synchroniseren.