Voor Microsoft Dynamics 365 Business Central Cloud-implementaties kunt u ervoor kiezen om de Perk Spend Management Connector te installeren vanuit de AppSource of 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 Cloud in te stellen:

1. Installeer de extensie via de AppSource of als een uitbreiding.
2. Configureer de webservice in Business Central Cloud..
3. Configureer de connector in Business Central..
4. Exporteren instellen in Perk:
   • kosten exporteren
   • factuur exporteren
5. Synchroniseer stam- en transactiegegevens..

Installeer de Perk-connector vanuit Microsoft 365 Dynamics App Source.

Om de Perk-connector te installeren, zoek je naar de uitbreiding in de AppSource door Perk te typen en te klikken Koop het nu.

Hiermee wordt de extensie geïnstalleerd in uw Microsoft 365 Dynamics Business Central-tenant.

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-reeksen zijn dynamisch en kunnen worden beïnvloed door de licentie van de klant.
Als de klant deze ID-reeksen gebruikt, moet u mogelijk een andere reeks 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.

Stel de webservice in in Business Central voor Cloud.

Aangezien Business Central verantwoordelijk is voor het ophalen van gegevens uit Perk, moet u de webservice in Business Central aanmaken om dit proces af te handelen.

1. Registreer een applicatie op de MS Azure-portal..
2. Publiceer de webservice op de pagina 'Webservice' in Business Central..
3. Wijs de juiste machtigingen toe in Business Central..

Voorzichtigheid: Zorg ervoor dat u de sandbox-vernieuwing uitschakelt als u de extensie in een testomgeving installeert. Anders moet u de extensie na elke vernieuwing opnieuw configureren.

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://businesscentral.dynamics.com/OAuthLanding.htm
   • https://businesscentral.dynamics.com/
   • https://test.yokoy.ai/oauth2/callback (Perk-test) of https://app.yokoy.ai/oauth2/callback (Perk prod)
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 Klant-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 het volgende nodig: Perk BC-toestemmingsset (PERMISSIONSET YKY) om eventuele latere wijzigingen in de integratie aan te brengen en gegevens te synchroniseren.

Vervolgens 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.

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:
   • Onkostenverwerking: Importkosten YKY (3110567)
   • Factuurverwerking: Webhooks YKY (3110566)
5. Voer een unieke servicenaam in (bijv. factuurverwerking of onkostenverwerking). Zorg ervoor dat de Gepubliceerd Het selectievakje is aangevinkt.

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.

Je moet het tabblad voor het exporteren van onkosten instellen (Beheerder > Integraties, Exporteren van onkosten) om onkostengegevens (uitgaven, kaarttransacties, reiskosten) naar Business Central te verzenden. 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 Kosten exporteren integratiekaart.
3. Kiezen Business Central [API] als de ERP-systeem.
4. Voer de authenticatiegegevens in:
   • Azure Directory ID: Business Central tenant-ID
   • Klant-ID: MS Azure-portal client-ID die eerder is aangemaakt
   • Klantgeheim: 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:

De instelling voor het exporteren van onkosten Kostenobjecten uitsluiten van de 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 Factuur exporteren kaart.
3. In de Factuurexport tab, klik Startwizard.
4. Vul deze gegevens in:
   • Exportnaam: Facturen van Business Central
   • Documenttype: Facturen van leveranciers
5. In Systeem tab, selecteren Business Central-integratie.
6. 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.