For a sette opp integrasjon mot Business Central i Account Control trenger vi API-tilgang til deres Business Central-miljø. Dette settes vanligvis opp av deres IT-personell, eller deres Business Central-leverandør.
Fremgangsmåte for registrering av app
Klikk for å vise seksjon
1. Navngi app-registreringen
2. Legg til "API permission" av typen "Dynamics 365 Business Central"
3. Velg "Application permissions" og velg "API. ReadWrite.All"
Roller og tilgang styres videre i Business Central
4. Klikk på "Grant permissions"
5. Opprett en "secret"
Informasjon som må sendes til oss
Klikk for å vise seksjon
1. Application (client) ID
2. Endpoints
3. Client secret value
NB! Vi trenger "Value", IKKE Secret ID.
4. Tenant-ID
Dette er en identifikator for tenant/kunde i Business Central, og kan hentes blant annet via Microsoft Entra admin center ved å følge stegene under:
- Logg inn på Microsoft Entra admin center som en global administrator.
- Naviger til Azure Active Directory (eller Identity), så Overview i undermenyen.
- Tenant ID vil ligge under under Basic information (punkt 3), som vist i bildet under.
5. Miljønavn
Navn på Tenant-miljø som skal brukes for integrasjonen. En gitt Tenant i Business Central kan ha flere miljøer, f.eks. "Test", "sandbox" og "produksjon". Navnene på disse er generelt definert av kundens Business Central-leverandør. Vi vil typisk ønske å registrere produksjonsmiljøet i Account Control.
6. PTE (Per-Tenant Extension) app
Vi har vår har sin egen PTE app for å knytte Business Central til Account Control. Den må installeres i kundenes Business Central-tenant i følgende tilfeller:
- Integrasjonen skal brukes for kontoavstemming i fremmedvaluta.
- Integrasjonen skal brukes for balanseavstemming.
Installasjonsfil for vår PTE-app må oversendes til deres Business Central-leverandør. Siste versjon er tilgjengelig for nedlasting her: Account Control Business Central PTE App
Når PTE-appen er installert, vil filstien til vår PTE-app som oftest være saveSolutions/base i Business Central.
7. Oppgradering til Business Central versjon 26
I forbindelse med oppgradering av D365BC til versjon 26, så er det noen felter som erstattes av nye i denne versjonen. Dette krever at dere installerer en ny versjon av vår PTE app FØR miljøet deres oppgraderes til versjon 26.
Det er viktig at dere sjekker følgende i produksjonsdatabasen deres før dere installerer siste versjon av PTE appen:
- Sjekk at feltet Purch. VAT Reporting Code (nytt felt) har samme verdi som feltet Purch. SAF-T Standard Tax Code (gammelt felt)
- Sjekk at feltet Sale VAT Reporting Code (nytt felt) har samme verdi som Sales SAF-T Standard Tax Code (gammelt felt)
Hvis feltene ikke har samme verdi, så må databasen oppdateres slik at de nye feltene har samme verdi som de gamle, ellers kan det skape uoverensstemmelser i Account Control. Når feltene har samme verdi, kan dere installere siste versjon av PTE appen, og deretter versjon 26 av D365BC.